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CHAPTER 1 


ASSTRACT 


1.1 ASSTRACT 


This document is the functional soecification of the software 
features to b2 orovided in the C7123 oroduct. References are nade to 
the hardware to the extent necessary to descrite the susport required 
from nardware to implement the functions made available through the 
software. For detailed information on the hardware refer to the C7128 
Hardware Specification. 


CHAPTER 2 


INTPODUCTION 


2el MACHINE CONCEPT 

Tne C7128 is intended 35 39 \Upyrade ano successor to the 
commercially successful C4#4. The Cr-122 takes advantage of the already 
developed base of €-64 software Sy oroviding a totally C-44 ‘comoatibdble 
mode of operation. In addition it provides an uograde oath by 
imolementing features that are normally found in much nore exoensive 
machines. Soecifically these featur2s ares 

12 122K oytes of user accessidle RAM 

ge 29 character column outout 

3e CP/M 3.0 overation 


There are other features that are veinj acdced4 sut the ones Listed 
above are2 most significant tin terms of value added versus the €~54. 


2e2 SOFTWAPE/SHARODWARE SOSCIFICATION OVEPVIEW 


The software/hardware features provided oy the C€-123 machine are 
Summarized below: 


C-64 Compatible Mode 


Ve Standard C€-64 Kernal 


2e 3ASIC 2.0 


3. 40 column output via VIC IT chip = (modified 1 or 2 MHz 
clocks extra keyboard lLiness etc.) 


4. Sound via SID cnio 
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Access to €4K onytes of RAM 
Standara C764 keysoarad layout 


Full comoatibility with C-54 seripherals includina standard 
€-54 cassettes jaysticks,user ports and serial bus devices 


Full comoatibility with C€-44 aoplications software 
P-44 comoosite video and RF output 
85900 CPU at 1 “AZ 


Moda 


New enhanced C-12"% kernal 
RASTC 7.9 

49 column outout via Vic II 

39 column outout via 35635 chip 
Sound via SID cnioa 

Access to 128K dytes of RAY 


Enhanced keyboard (numeric padsescanpestabscaops Lockshelo key) 
in addition to stanzard C746 keyboard. 


Access to fast serial floso0y sgsisk and regular serial 
peripherals 


Access to RAM disk when 258K x 1 SA" are available(not in 
current design) 


4ode 


CP/4 3.29 via tntesral Ir2cA 

490 column outout via VIC II cnip 
8G column outout via 27563 chip 
Sound via SID chic 


Access to 128K oytes of PAM 
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be Access to full keyboard 


7e Access to fast serial disk and regular serial serioherals 


Be Access to RAM disk when 256 x 1 9A4% are availanle Conly in 


CPs" design) 


203 HARD WAPE COMPONENT SUMMARY 
(For greater sgetail see C€-123 Hardware Soecification) 


Processors: 3509 CCo4eE07129 MaodesszI/0O stsrpoort for CP/M) 
LBRQ7A (CP/4% Made anly) 


Memory: 
204s 64K standard (€C-64 Kernal + AASICs, C7123 Kernal + BASIC, 
character ROMs and C®/Mm 3103S) 
1=32K slot available for function key software 


RAMs 125K bytes in 2-44K byte banks 
16 K bytes screen RAM for 3553 video chio 


Vigeo Chips: 3567/256x 4) column video (Cvearsion for NTSC and PAL 
TV standards) 
A503 20 column video 
Sounds 6531 S19 Chio 
[/0: 6526 Joystick oorts/keyooard scan/cassette 


605258 User and serial ports 


Memory 
Management: PLA (C704 + C-128 “Mapping Yodes) 
MMU (Custom gate array) 


204 COMPATISILITY OSJSECTIVE 


The C~-128 system is desiqned as an upgrade to the C764. The 
prime objective is to maintain hardware and software compatibilty with 
the C-64 when operating in C754 Modee The C764 mode of the €-128 will 
be capable of running alt €-$4 apolication software. It also wilt 
support all C~-54 peripherals oxc2ept the external CP/M card (the ¢-123 
has internal CP/M capability that supercedes that provided by the 
external card). 
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The C7122 mode is designed as a compatible superset to the (-454. 
Specifically, allt kernal functions provided by the C-64 will be 
provided in the €-123 kernal. They are also provided at the same 
Locations in the jump taole of the C-122 kernal to allow compatioility 
with SASIC programss Howevers Locations within kernal/3ASTC that aay 
have oeen cailed directly will not be juaranteed to pe at the same 
Locations as in the C734 kernal. where ovossible new entries will be 
added to the €-123 jump table to replace these direct calls to kernal 
and BASTC routines. An attemot will be mage to naintain zero page and 
other system variaoles at the same addresses tney sccupy in C-04 mode. 
This will simolify interfacing for many programs. 


The objective to provide full €-64 compatibility also leads to 
certain constraints. The main constraint is that the C=64 Yode cannot 
take advantaye of all the new features of the machine (this ts why the. 
C-123 node was added). For 2axamoles a new fast serial disk will se 
part of the C-1238 system. Due to comoatibility and memory constraints 
it is not possible to modify the C646 kernal to support the new fast 
serial disk drive. C7454 will see this cisk as a standara serial disk. 
Similarly, the €-64 mode does not have an $39 column screen editor for 
the same reasons. Alsos €-54 SASIC does not automatically use the 
second 54K banx of memory. This second bank is used for variable 
storage by C-123 aAaASIC. 
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Cmt4 COMPATIQPLE “IQ0e 


The €-454 kernal and ASIC are ineluded unenanged in the (C-123 
System to provide comolete comoatibility with C-64. For a complete 
description of the following items refer to the C=-64 Programmer's 
Reference Suide. 


1. C€C-64 sASTC commands, statementss ana functions 
2e HOw to use the VIC chin 
3.2 How to usa the SID chins 


4. (C754 Kernal function accessible through jump table 


Note: in addition ta the 46 reyisters that can de accessed in 
the VIC chip there are 2 aaditional registers accessible to the user 
for the C-123. They are: 

Rege 47 - Keydoard Control Reoister 


The keyboard control register determines the status of the three 
keyboard interface tines. Bits oO-2 of register 47 are directly 
reflected in Lines “U-K3. "its 477 are not connected and return 4a 
high when read. 


Rege 46 - 2 “HZ BIT 


The 2 “HZ bits Dit J of reqister 48, sets the speed of the 2 MHZ 
clock out. This bit also stoos all VIC accessess except DRAM refresh, 
from occurring. VIC cannot generate any address except during these 
refresn cycles. For normal VIC operations tthis bit must be clear. 
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MODE SWITCHING SUMMARY 


The following taole shows now to Switch oetween the various C123 modes. 
The columns of the table show the current state the user is ine The 
rows of the table show the state the user would like the system to be 
ine To change the state of the machine the user should locate the 
column containing the state the machine is currently tin. Then tne user 
should find the row containing the state they would like the system to 
be ine The intersection of this column anc row contains a4 obrief 


description of the action the user should take to change states of the 
machine. 


MODE SwITCHING SUMMARY Pazse 4-2 
C122 “ODE SWITCHING 

JCUQRENT | |} C44 | ¢123 tf (i232 | cPpys™ 1 cps 
{STATE J OFF | 1 39 COL { 40 COL 1 40 COL 1 3c COL ; 
[Sasa | | | | | 
JOESTRED| | | i | 
[STATE | | i | | 
(arses ae eee a ee aera aaa aaa a cera ata arieae pote eces= > (ean ee amene ’ 
J OFF | -- [TURN POWER] TURN POWER|[ TURN POWER2I TURN POWERJTURN POWER, 
| ] \ OFF | OFF | OFF i OFF | OFF i 
a ae Grae ee ere eee ee eng ee ere pe es ee ee ee, ee ee 
[C64 1TURN ON i -- | 3044 GO054 [TURN OFF  |TURN CFF I 
| JwITH C44 | [| COMMAND | COMMAND |[SEE OFF JSEE OFF 

i ICARTPIDGE | i | |STATE [STATE | 
aa lige, aia has aaa aaa ic ana as ee eee arene ea eae 
i | ! | pest=x. 08 f | | 
[ci26 {|  TuPN ON | ReSecT | =< SET 40 COLICYCLE PWR JCYCLE PWR 
(30 COL [w/8S COL |Jw/80 COL | [SWITCH AND{[W/30 COL, [w/80 COL | 
i [SWITCH SETISWITCH SETI PRESET 09 |SWITCH SET] SwITCH SET 
i i | | JRIN/STOP+ |. | | 
l { | | J RESTORE | | 
a ad aca a aa aac eat, (ea cael | aaa en le 
i i JESC X OR | | | : 
jci23 | TURN ON | RESET FSET 460 COL] ICYCLE PwR [CYCLE PWR | 
140 COL [W/40 COL Jw/50 COL SWITCH AND] -- 14/40 COL fe/45 COL ! 
| {SWITCH SETISWITCH SETIRESET OR | JSWITCH SETISWITCH Sil, 
| 1 ] {RUN/STOP+ | { | i 
| | | RESTORE | | [ ' 
ORE Secmatl Neispistetacbrisran is Aira ac en ee [Se 2es >= | SesS=s=S= [Sra s eRe { 
jcPpss™ AUTO COOT JRESET wITHJSOOT CMD |300T CHD |} JASSIGN VIA. 
140 COL JOISK IN JAUTO OCT JOR QESET+ F929 AcSeETe | == DEVICE CMO| 
( PORIVE+4O JIN ORIVE+ [AUTID FOOTHIAUTO ZO00TF{ ! TO 40COL 

i }COL Sw SETI40 COL Sw 440 COL Sw 449 COL Si | | | 
rere | ee se Pee ee et re fe ee ee nee CeO eueeE a pare Gene 
jcops™ JAUTO BOOT JRESET wITHJRCOT CMD |[300T CMO JASSIGN VIA] 
180 COL JOISK IN {AUTO 309T JOR RESET# JOP RESET JODEVICE CMD] “= : 
{ PDRIVEtIO FIN DRIVES JAUTO SDOT+I AUTO BOOTH] TO 3UCOL | j 
| JCOL SW SETI80 COL Sw [3G COL Sw [60 COL Sw | | : 
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NOTES: 


1. 


Pressing the reset switch reinitializes the machine in the same 
way as cycling power. 


The *RUN/STOP + FESTORE™ sequence neans that the “RUN/STOP”™ is 
held cown while the “RESTORE” key is momentarily oressed. This 
performs a subset of the operations oerformed by cycling oower 
or oressing the reset switch. 


An "AUTO 390T DISK” is a soecial diskette that when loaded into 
a Gisk drive contains a progran which will automatically load 
and run when the computer is powered on. 


A C464 cartridge takes orecedence over an autos ooot disk = at 
system power ud. iif 3a C94 cartridge is oslugged tins the system 
always powers us in C456 node. 


In €123 mode the escanoe sequence ESC X tojzgles between 40 ana 
®9 column indeoendent of the state of the 46/390 column switch. 


See the GRAPHIC command in SASIC for other ways of toggling 40 
and 89) column screans. 


Under certain conzitions both 49 and 293 column screens can  ~0be 
made to appear active at the same time. Details on how this is 
done will appear in a tater version of this spec. 


In C64 mogce the system MMU Js mot accessidle. However, tne RA” 
bank the system executes from will be that selected in the M*U 
before the €64 kernel and 3ASIC R205 were enanled. 
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C54/C"123 “CDE 


5e1 MACHINE LANGUAGE MONITOR 
Se 1-1 INTRODUCTION 
The C-128 MONITOR ts a Duilt in machine Language orogram that Lets 
the user easily srite machine Language orogramse. C-122 MONITOR includes 
a machine Lansuage monitors a mini assemdlers and a disassemoler. 
Machine language programs written using C-128 MONITOR can run oby 
themselvess or be used as very fast ‘subroautines® for 3ASTIC programs 
since C-128 MONITOR has the ability to coexist peacefully with SASIC. 


Care must be taken to oasition the assemcoly lLanquagce prosrams' in 
memory so that the SASIC projzran does not overwrite then. 


Sete2 Cm12% MONITOR COMMANDS 


Te A ASSEMBLE ~- Assemble a line of 4592 code 


oe C COMPAPE = Comoare two sections of memory and report 
differences 


3. OO DISASSEMBLE = Disassemble a line of £5902 code 
4. F FILL ~ FILL memory with the specified byte 
Se G&6O - Start execution at specified address 


be H HUNT - Hunt through memory within a specified range for alt 
gecurences of a set of bytes 


7e bl LOAD = Load a file from tape or disk 
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Ze 4 MEMORY = Disolay the hexidecimal values of memory Locations 
Fe @ REGISTERS = Disclay the 5502 registers. 
19. S$ SAVE - Save to tase or aisk 


11.2 YT TRANSFER = Transfer code frem one section of memory to 
another 


120 V VEPIFY =~ Compare memory with tape or Jisk 
ce X EXIT ~ EXIT C7123 MONITIR 
14. Coertiod) = Assembles a Line of 85732 code 


15. > Cgreater than) - Aodifies memory 


146.2 - Csemirmcolon) - AHoaifies 465C2 recister disolays 
17-9 2? Cat sign) = Disalay disk status 
1/ The MONITOR now accepts dinarys octals decimal and hexideciaal 


values for any numeric field. This was accomplished by totally 

recoding PARS® ana partions of ASSS*, and installing a new 

routine called EVAL. Numbers crefixed sy ane af the characters 

$ + &§ & are interoreted oy EVAL as base 184 107 34 of 2 values: 

respectively. In the absence of a prefixs the dase defaults to 

nexidecimal always. ASSEM will use tne zero-page form wherever 
passible unless the value is preceeded by extra zeros to force 
the absolute form Cexceot dinary notation). 


of The MONITOR now perrorms Linited nunoer conversion. Additions 
were made to MAINT anc CMOCHR and a new routine called CINVERT 
w2S tmstalled to hanale the conversions. Any of the characters 
> * & % enterea as a command and prefixing a numeric value are 
PARSEdG (see #1 adove) and the nexicecimal value printed. Full 
conversion between dases may be added in a Later release. 


The Sth most significant nyoble of the address field soecifies the 
memory configuration to imolement at the time the jiven command is 
executed. There are 15 (O73F) possiole memory configurations. Refer to 
the ‘Memory Configuration Taole* below for the specific assignments. 
(These assignments apoly to all 3ASTC and KERNAL routines). 


Examole of memory display in monitor mode: 
x 2299 


MEMORY CONFIGURATION TA2LEe 


C64/C~-123 MODE 


where x = 


rAMOWOOaD PF YOANN DA KWo 


RAM 
RAM 
2A6 
RAY 


EXT 


ati wt ©) 


only 
only 
only 
only 


KON» 
ROM,» 
ROM, 
ROM, 
RIM» 
ROM, 
ROMs 
ROR, 


SERNAL + 


KERNAL 
KERNAL 
KERNAL 


++ + 


RAM 
RAM 
RAM 
RAM 
PAM 
9AM 
RAM 
QAM 
INT 
EXT 


{lo), RA™ 
(lo), 2AM 


RASICs “AW Ge 


1, 


Se I/9 
Iso 
CHARROM 
1/9 


17 - 
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Se1e-2.1 C7128 MONITOR COMMAND DESCRIPTIONS - 
COMMAND: A 
PURPOSE: Enter a line of assembly code. 
SYNTAX: A <address> <opcode mamnemonic> <operand> 


<address> A hexadecimal number indicating the location 
in memory to place the opcode. 


<opcode mnemonic> <A standard MOS technology assembly 
Language wnemonics e@jes LDAr STXs IR 


<operand> The operands when requireds can be of any 
of the legal addressing modes. (For zera-page 
modes a2 digit hex number is whose vatue is 
less than £100. For nonmzero page addresses 
4 digit hex numbers are required.) 


A RETURN {$s used to indicate the end of the assembly Line. if 
there are any errors on the Lines a question mark is displayed to 
indicate an errors and the cursor moves to the next Line. The screen 
editor can be used to correct the error(s) on that line. 

EXAMPLE: 


2A 1200 LOX #30C 
eA 1202 


NOTEs A period (.) is equal to the ASSEMBLE command. 
CXAMPLE: 


© 2000 LDA 4323 
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C64/C-128 MODE 


COMMAND: C 
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PURPOSE: Compare two areas of memory. 
SYNTAX: C <address 1> <address 2> <address 3> 
<address 1> is a hexadecimal nuaber indicating the start 
of the area of memory to compare against. 
<address 2> is a hexadecimal number indicating the end 
of the area of memory to compare against. 
<address 3> is a hexadecimal number indicating the start 
of the other area of memory to compare with. 
Addresses that do not agree are orinted 
on the screen. 
COMMAND? D 
PURPOSE: Disassemble machine code into assembly language mnemonics 


and operands. 


SYNTAX: D C<address>] C<address 2>] 


<address> 


A hexadecimal number setting the address to 
start the disassembdly. 


<address 2> An optional hexadecimal ending address of code 


to be disassembled. 


The format of the disasseably is only slightly different than the 
The difference is that the first character 
of a disassembly fis a comma rather than an A (for readability)s» and the 
hexadecimal of the code is Listed as well. 


f{nout format of an assemoly. 


A disassembly listing can be madified using the screen editor. 
“ake any changes to the mnemonic or operand on the screens then hit the 
carriage return. This enters the Line and calls the assembler § for 


further instructions. 


A disassembly can be paged. 


Typing a dD <return>causes the next 


page af disassembly to be displayed. 


EXAMPLE: 


0d 3000 3003 


3000 A900 LDA #8$00 
e 3002 FF ss 
23003 00 28 SNE $3030 
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COMMAND: F 

PURPOSE: Fill a range of locations with a specified byte. 

SYNTAX 3 F <address 1> <address 2> <byte> 
<address 1> The first Location to fill with the <byte>. 
<address 2> The Last Location to fill with the <dyte>. 
<byte value> A111 or 2 digit hexadecinal number to be written 


This command is useful for initializing data structures or any 
other RAM area. 


EXAMPLE: 
F 0400 0518 EA 


Fills memory Locations from $0400 to $0518 with 
SEA (a NOP instruction). 


COMMANDS G 
PURPOSE: Begin execution of a program at a specified address. 
SYNTAX: G@ <address> 
<address> The address where execution is to start. 
When address is left outs execution begins 


at the current PC. (The current PC can be 
viewed using the R command.) 


The GO command restores all registers (Cdisplayable by the P 
command) and begins execution at the specified starting address. 
Caution is recommended in using the GO command. To return to C-128 
MONITOR mode after executing a2 machine language programs use the SRK 
instruction at the end of the progras. 

EXAMPLE: 
G 140C 


Execution begins at location $140C. 
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COMMANDS H 


PURPOSE? Hunt through memory within a scecified ranse for alt 
occurences of a set of dDytas.e 


SYNTAX: Y <address 1> <address 2> <gata> 
<address 1> peginning address of hunt orocedure 
<adaress <> ending acdress of hunt orocedure 


<data> data set to search for data may de 
hexadecimal or an ASCII string. 


EXAMPLES 


4 43939 A191 AS FF 4C Search for data $A?~p 
SFF, $4C, from AQODD 


to A1)1. 
COMVANDS L 
PURPOSES Load a file from cassett? or disk. 
SYNTAX: L <"filename">l, <device>] Cralt_load_address] 
<*“filenane™> Is any legal C-122 filename. 
<device> Is 3 hexacecinal numoer inaicating the 


device tc load fron. 


Calt_loajd_addressjJ option to load a file to a 
soecified address. 


1 is cassette 
3 as disk Cor Ie Av etce) 


The LOAD command causes 4 file ta be loaded into memory. The 
starting address is contained in the first two bytes of the file (Ca 
program file). In other worass the LOAD command always loads ae file 
into the same olace it was ’ saved from. This ts very important in 
machine Language works since few programs are completely relocataole. 
The file is loaded into memory until the end of file CEOF) is found. 


EXAMPLE 


L "PROGRAM 1%,8 Load the file named PROGRAM 
from the disk. 
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COMMAND: “i 


PURPOSES To display memory as a hexadecimal and ASCII dump within 
specified address ranoe. 


SYNTAX: 4“ C<€address 1>] (C<aadress 2?) 


<address 1> Pirst address of memory dumde IJotionals 
if omitted, one cage is aisolayed. 
The first oyte 3s the cank numoder to 
se displayed» the next 4 bytes are the 
first adaress to oe disolayead. 


IND 
V 


<address Last address of nemory dumpe OSotionals 
if omitteds one sace is disolayec. 

The first syte is the oank numoer to 
ne displayed, the next 4 bytes are the 


endings aderess to de disolayed. 
Memory is. displayed in the following format: 


>74969 441 ©7 DC AA AA QO 93 65 45 SA! eee. VE 


Memory content may be edited using the screen editor. “ove the 
cursor to the data to be moatfied and tyoe the desired correction anc 
hit return. If there is a bad RAM Location or an attemot to modify RO” 
has occureds an error flag (7) 18s disolayed. An ASCII dump of the cata 
is displayed in REVERSE (to contrast with other data disolayed on the 
screen) to the right of the hex datae dhen a character ts not 
printables tt is displayed as a reverse period (.). As with the 
disassemoly commands, paging sown 1s accomplished by tyding ™ and RETURN. 


EXAMPLE=s 


>21€00 41 €7 FC AA BA OO 98 56 45 sAle*.e VE 
>21C908 42 43 92 AZ AD 171 946 57 44 335C ete eWd 
>21010 45 =7 OG OF FE O7 069 46 47 sELeeewEF 


the 
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COMMAND: R 


PURPOSES Show important 6502 recisterse The program status registers, 
the proyram counters the accumulators the X and Y index 
registers and the stack pointer are displayed. 

SYNTAX: R 

SK AMPLE: 
Q 


PC SR AC XQ YR SP 
, 1052 OF O2 £3 DS FS 


NOTEs 7 (semiccolon) can se used to madify reqister displays 


in the same fashion as > can be used to mocify memory 
resisters. 


COMMAND: 5 
PURPOSE: Save the contents of memory onto tape or disk. 
SYNTAX: S <“filename™>,<devicer>s<address 1>/<address 2> 
<"filename”™> Any lecal C-122 filename. To save the datas 
the filename must be enclosed in double 
quotes. Single quotes cannot be used. 
<address 1> Starting address of memory to be saved. 
<address 2> Ending address of memory to be saved ¢+ 1, 


ALt data un to out not including the byte 
of data at this address is saved. 


The file created by this command is a program file. The first two 
Dytes contain the starting address <address 1> of the data. The file 
may be recalled by the L command. 


S "GAME" 7840400 -OBFF 


Saves memory from $0400 to SOBFF onto disk. 
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COMMANDS T 


PURPOSE: Transfer segments of memory from one memory area to another. 
SYNTAX: T <address 1> <address 2> <address 3> 
<address 1> Starting address of data to oe moved. 
<address 2> Ending address of data to be moved. 
<address 3> Starting acdress of new location where data 


will te moved. 


vata can de moved from low memory to high memory and 
vicemversa.e 4dditional memory segments of any Lergth can 
De moved forward or backwarde An automatic ‘comoare® is 
serformed as f#ach dbyte jis transfered and any differences 
gre Listed by address. 


EXAMPLES 
T 1400 16090 1401 
Shifts data from £1400 up to and including 
$1600 one oyte higher In memory. 
COMMAND: V 
PURPOSE: Verify a file an cassette or disk with the memory contents. 
SYNTAX: V <"filename™>C, <device>j] Crealt_start_address] 
<"filename™> Is any legal C-128 filename. 
<device> Is a hexadecimal number indicating which 


drive the file is on, 
cassette is 1 or O14 disk 18s 2 or O&8s% 99 etc. 


Calt_start_address] ootion to start verification at 
this address. 


The verify command compares a file to memory contents. The C€-128 
responds with VEQIFYINGe. If an error is founds the word ERROR 18 addeds 
if the file is successfully verifieds the cursor reappears. 

EXAMPLES 


V “WORKLOAD”, 6 


C64/E-123 MODE 


COMMANDS 
PURPOSE: 


SYNTAXs 


COMMAND: 
PURPOSE: 


SYNTAX: 


COMMAND: 
PURPOSE: 


SYNTAX: 
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x 
Exit to 3ASIC 


X 


> (greater than) 

Can be used to set 1 to & memory Locations at a time. 

> address cata byte 1 <data byte 2..2-3> 
address: First memory address to set 
data byte 1 Data Cin HEX) to be put at address 
<data Syte 2e.e22>: Data to be placed in the successive 


memory Locations following the first 
address. Cootional) 


3 Cat sign) 
Can be used to disolay the disk status 
3 C unit#Il, disk cmd string 
unit # device unit number Cin HEX) 


disk cma string String command to disk 


NOTE: sw alone gives the status of the disk drive. 
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Sel C7122 EDITOR ESCAPE SEQUENCES 


This section contains a definition of the escane sequences tnat are 
present in the C123. i 


The following is a definition of the ESCAPE sequences that are available 
an the C123 and a Srief descriotion of what each sequence does. ESCAPE 
sequences are entered Sy momentarily oressing the “ESC xey foliscwed oy 
the key Listed Selow. 


Koy FUNCTION 


Enable auto~minsert mode 

Set sottom of screen window at cursor s30sition 
Disanble auto~insert nove 

Delete current line 

Set cursor to none-flashin3y mode 

Set cursor to flasnina mode 

Enable bell Ccontrol-3) 

Disaole dell 

Insert line 

Move to start of current line 

Move to end of current Line 

Enable scrollina 

visable scrolling 

Return screen to normal (nonmreverse video) state (80 column 
screen only) 

Cancel inserts quotes and reverse moces 

Erase to start of current line 

Erase to end of current Line 

Set screen to reverse video (30 column screen only) 
Change to block cursor (5c column screen only) 
Set top of screen window 3t cursor oastion 
Change to under (890 column screen anly) 

Scroll up 

Scroll down 

Swao 40/39 column disolay outout device 

Set aefault tad stons (2 spaces) 

Clear all tan stops 

Clear to end of screen 


2eaoPrnent Zaaunmoonwe > 


VN «Kk L£Ceo An De VO 
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Jed CICS EDITOR CONTROL CODES 


The following control characters in the C5 ASCII tadle have been added 


or changed from those foundc’in the C64. Codes not shown in this table 
have tne same function as found in the C64. 


CHRS KEY°OARD 

VALUE CONTROL CHARACTER FUNCTION 

2 3 Unaerline on (309 column screen only) 

7 5 Produces bell tene 

9 I Tac character 

10 J Line feed character 

41 K Disable shift Connodore key (formerly code 9). 
12 L Enahle shift Commocore key (Cformerly code 38) 
15 0 Turn on flash aon (3° column screen only) 

24 X T30 set/clear 

27 C escaoe character 

139 Underline off CEL column screen only) 

143 Turn flash off (EQ column screen only) 
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SYSTE™ MEMOVZY MANAGEMENT 


601 INTRIDUCTION 


The “EMOPY MANAGEMENT UNIT C€¥*"U) Is designed to allow complex 
control of the C-12& system memory resourcese It hanales all of the 
standard €54 modes of oceration in 3 fashion as to oe completely 
compatible with the C64. Aaditionallys it controls the management of 
Particular C-123 modes incluaing the Z8C nodew selow is a list of MY 
features: 


1-2 Seneration of Translated Address sus (TA = TA15). 


Ce § «6G eNeration of control signals for <daifferent processor modes 
CC-1254 C64, 7220). 


32 Generation of CAS select Lines for RAM Sanking. 


Se2 €123 MEMORY ORGANIZATION 


Essential to the underscanding of the 4*YU is an understanding of 
the C-123 system memory organizations which is controlled through the 
registers of tne “MU. These registers control the *MU's translation of 
addresses from the &500 processor, totalling 64K bytes of address snace,s 
into the 14 bytes of RAM and up to 960K internal »vytes and 32K »dsytes 
external R29 available to the C-123 syst2m. Following is a diagram of 
the C-123 memory Nao. 
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Figure 2-1. C128 Memory Map 
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Ge2etl C-122 ROM MEMORY ORGANIZATION 


Refer to figure 6.1 entitled C1c& Memory Yacoe The memosy map is an 
important consideration in naintaining C&4 compatidility. The standard 
mao is shown for the €44 mode and some of the alternate modes are shown 
in figure See, €54 Alternate Memory Organization (To ve suppliec). All 
C64 modes are comoletely compatible with the C54 computers, as the C7125 
basically becomes a C64 when tn C54 mode. The details of MU Register 
Location/operation are discussed further in this chaoter. 


C-122 mode is achieved at system reset, and is controlled by a bit 
in the MMU configuration register. In C7123 node the “MU asserts itself 
in the C-1283 memory map at SFFOO and in the [/0 space starting at $0503. 
Use of "MU registers located at SFFOO allows memory management without 
actually having the 170 block vanked in at the time and with a minimum 
Loss of conticuous RAM. The “MU is completely removed from the memory 
map in C64 mode (though it is still used by the hardware to manage 
memory). 


The ROM’ s in C44 modes doth internally and externally, look just 
like the C54 R0@%s. The internal SASIC and KERNAL provide the C54 mode 
with the mormal C64 operating system in ROM. This ROM actually 
duplicates some of the RO” ysed in C-122 Mode. In C7128 modes up to 43Xk 
of Sperating System is oresents with the exact amount bdeing set ody 
software control. This allows quicker access to underlying RAM by 
turning off uneeded sections of the Operating System. 


The External ROM*s represented on the memory mao are those used in 
the C64 modes, and obey the C54 rules for mappinas i.e. cartridg?s 
assert themselves in hardware via the /JEXRO4 and /GAFME lines. externa: 
ROM’ s jin C7128 mode obey rules similar to the TED scheme for 20™ 
pankings ie@e they are polled at system initialization to see if they 
exist and what priority they are to run withe This allows much more 
flexibility than the hardwire ROM substitution methods since the kernal 
and @asic ROMss can be swapped out for an aonlication programs swaoped 
out for external program controls or turned off all together. This 
oanking manipulation is accomplished by writing to the Configuration 
Register at location $0500 or SFFOU in the MMU. 


The hardware also features the ability to store oreset values for 
the configuration ana force a load of the configuration register by 
writing to one of the LCR CLOAD CONFIGURATION REGISTER) registers. This 
allows the programmer to imoly that any time an access to a bank where 
data is stored occurss for examoles that ROM not aopear in the dank ody 
default. 
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Settee C~m122% RAM MEMORY ORGANIZATION 


Refer again to figure 6.1, the C122 Memory Mao. The RAM present in 
the system 1s actually comoosed of 122K sy & bytes of contiguous DRAM, 
The RAM is accessed by banking in pages of 54K (the maximum range of the 
8500 and 24390). The area shown as PAM iS Feoresentative of what the 
microcrocessor would see if all ROM were disanled. svank switching can 
pe accomplishea in one of two ways. 


The bank in use is a function of the value stored in the 
configuration register. (There are actually a couple of memory modes 
that override parts of tne bank as selected here. These noses are 
mentionej and covereo in detail in a later section.) A store to this 
register will always take effect immediately. An indirect store to this 
registers using programmed sank canfiauration valuess can de 
accomplished by writing to one of the indirect load registers known as 
LC2R*s (Load Configuration Yes3ister)ds located in the SFFIO region of 
memory. “"y writing to an LCR the contents af its corressonding PCR 
(PreConfiguration Register) wilt de tLatcned into the confiyuration 
register. This allows the orojrammer to set un four different 
preproyrammed configurations that allow each bank to be personalized 
ahead of time. i.@er iank 1 dSeing a Data sank miqnt be strictly a RA* 
bank with no 20” of I/0 enabled, where Sanx 0 oeing the system RO” and 
1/90 enabled sy default. Additionally » reading any LCR will return the 
value of its correspoancins ?CP. 


When dealing with 454K banks of memory at oncey it nay be desirable 
to dank in Fank 1 but still retain the system RAM CStacks Zero oages 
Screensetc.) Tne “448U hus orovisions for what 1s referred to as comrrn 
RAM. This is PAM that does not banks, and is orogrammable in size as to 
whether it apnears at the too0e bottoms, or doth in the memory made The 
size is set by bits 0 ana 1 in the RAM Configuration Register (RCR). If 
the value of the bits is zerase 1K will be common. Values of ones two 
and three sroduce common areas of 4SKs 3K, and 16K respectively. If bit 
two of the RCR is sets DOottom memory jis held commons, if bit 3 Is sets 
then top of memory is common. In all casess common RA is physically 
lacated in dank 9. 


Zero page and oage onze can be Located {or relocated) independently 
of the ACR. when the orocessor access?s an address that falls within 
zero page or page 1 the 4M) adds to the high order processor address 
the contents of the °9 register pair or the P11 register pairs 
respectivelys ana puts this new address oan the buss inctuding the 
extended addressing sits 416 and A1?. PAM danking will occur as 
approoriate to access the new address. Write to the PQ and P1 registers 
witt be stored in a prelatch until a write to the Low byte of the zero 
page register occufrse This prevents any change to the system 
configuration from oaccuring until all changes have been completed, 
preventing an invalid interim state. 


At the same times the contents of the PO and PT registers are 
applied to a digital comparators and a reverse substitution occurs if 
the address of the 3500 falls within the page pointed to by the 
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register. This results 1n not just relocating the zero or one page but 
swaoping the zero or one oage with the memory that it replaced. Note 
that upon system resets, the cointers are set to true zero nage ana true 
page one. 


For VIC chip access, two bits in the MMU status register sudstitute 
for address lines A16 and A117, making it oossible to steer the VIC 
anywhere in the 256K range. 


Note that AEC is the mechanisa that the “MU uses to steer a VIC 
Soace addresss ie@es when AEC is Low a VIC access is assumed. This 
results in the VIC bank seing selected 3s well for an outside DA, since 
this too will pull the AEC Line Low. 


Se3 MMU AND I[/3 MEMORY ORGANIZATION 


The block of memory reoresented by the i/d nlock on figure 6-3 is 
an excanded view of the memory bSlock entitled I/0 +CHAROMs shown on the 
C-123 aemory maos figure 5-1. dhen the 1/0 slock exists CAnd it may not 
depending on the configuration in olace at the time)s access to VIC, 
S10 and 1/0 as well as the addition of the MMU can Se accomolished. 
ALL I/0 functions remain as they were oreviously on the C64 with the 
exceptiaon that the MU has been addec. with the exception of four 
registers that are asserted in the zero page in the €-128 modes all new 
MMU rejyisters aopear in an unused slot in the memory [/0 blocks though 
they will only appear in (C7128 moce. The descriptions for the “MY 
registers can be found in the section entitlea THE MEMORY MANAGE*EN™ 
UNIT. 


$0800 _.....{| sid: 
$0700 _..... (RESERUED } 
$0600 ___... £963 
$0500 ____.. MMU 


$0400 __.... 


Figure |/0 Block 
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604 MMU REGISTER DESCRIPTION 


The “MU is the mechanism by which the various memory modes shown in 
the C123 Memory Mao are chaosen.w. Additionallys the “MU provides for 230 
modjes which is not shown on that diagrame Following is a descriptison of 
the “4U register types. The figure entitled MMY Register Map is 
provided to illustrate some of the text that is to follow. Note that in 
C64 mode the MIU completely cacisappears from the system's memory wap. 


Note that the data out of the MMU 1s valid only on AEC high. This 
is mecessary to avoid cus contention during a WIC cycle. 
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Be4e1 THE CONFIGURATION REGISTER 


The CONFIGURATION REGISTER (CR) controls the ROMs RAs and 1/0 
configuration of the C7123 system. [t jis located at $0535 in I/0 space 
and at SFFOO in system space. 


In C7123 modes bit 0 controls whether an I/0 space ($0009 = SDFFF) 
or a ROM/RAM access occurse A Low will select I/04 a high wilt enable 
some kind of 2OM/ RAM acecess, the nature of which is controlled by other 
Sits in this register. The value of this bit is stored in a prelatch 
until the fall of the clock in order to orevent its changing in an 
unstable situation. In €54 node of tne I/9SE Lines the hardware Line 
driven dy this bits is forced highe Note that when not I79 spaces, the 
ROM/RAM access is controlled by the defined PO“ Hi configuration bits, 
that are described later. Tris pit resets to Je When the I/0 bit is 
highs 44U registers 0500 to 0502 will assert themselvess when the oit is 
lows, these resisters disanpear from the memory mane M*U registers FFID 
to FFO4 are always available in C123 mode. The hardware Line I/OSE 
always reflects the polarity cf this bit when in C123 mode. 


Ait numoer 1 controls orocassor access to ROM low soace (84000 °- 
S7FFFI, tin C-128 mode. If the bit ts Highs the area appears as RAMs and 
@ RAM access CAS enable is jenerated to the agoprocriate RAM banks, which 
is determined by the other bits in this register. If lows system ROM is 
Located in the space. This oit affects the memory status Lines “SO and 
MS1 which are decoded oy the PLA to aenerate ROM chip selects. 
Selecting 20" here drives both memory status lines low when thre 
processor address falls within the specified low space range. This dit 
resets low to include the C-12s Basic Low ROM, 


The next two ditss sits ¢ and 3, aetermine for C-128 the type of 
memory that will be lLocatec in the nid space (329000 S$BFFF). If they are 
both lows system ROM will 5e Located here. I[f tit 2 atone is higns 
internal function RO” is Located here. External function RVU™ apoears 
for bit 3 beitng alone highs ana 8A appearss along with the proper CAS 
generations for both bits set high. These bits also affect the hardware 
memory access Lines. when in the aforementioned mid block address 
ranges, ‘SO reflects the status of bit 3 and 4S1 reflects the status of 
bit 2. These bits both reset Low to start out with 3asic high. . 


Bits 4 and 5 determine the contents cf the high block ¢8¢CC09 - 
SFFFFE) for C-125 modes and have no effect an C64 mode. As with the mid 
space, ooth oits zero set uo systen ROM, Sit 4 high sets up internal 
function ROM., bit 5S high sets uo external function ROMs and both bits 
high set up FAM. Note that the I[/6 configuration bits when set for 1/9 
spaces leaves the area from $0000 to tDFFF as I/0 Space regardless of 
the values of these bits. If not set for 1/0 spaces, $0000 to  SDFFF 
contain the character ROMs thuss there is always a hole in high ROM. As 
with the other ROM selection bits, these bits are reflected by the 
memory status Lines when this region of address is accessed. 3837t 5 
corresponds to MSO and bit 4 to MST. B30th of these bits reset to low to 
permit Kernal and Character ROM to locate this address space. 
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Note that there is always a hole in hish RO” during C125 mode (for 
the MSU registers at FFCL to FFOG. This hole is brought aodout by 
holding psoth “S Lines high and both CAS enable Lines high. 


Finally, sits 6 and 7 control the RA¥* oank selection. Their 
actionis dependents thoujghse uvon the version of the “MU. For the 
currents 123K systems only hit $ is actually sijnificant. Sir 6 low 


will select Sank Zero dy crooping CASU; bit 4 will select Sank one dy 
dropping CAST. it 7 tn this configuraation does not co anything. Note 
that for 32 R24™ share status that is nonwzero will override the normal 
CAS enable generation to scrovice CASS for all shared memory. Alsos for 
any area of memory that does not have its 8C% bank cits set for PA* 
accesss sJoth CAS enasle Lines will be high. For any access to the MU 
Pegisters from FFOU to FF24, Soth CAS enadle Lines and both MS Lines 
wilt be high. Not ethat in C54 mode the cank used follows the same 
rules as tn €123 modes, thoaoush banks cannot be cnangqed once in C54 mode. 
The 250K bonding option reclaces rhe two CAS Lines with etranstated 
adsress lines T4816 and TAI7.] [nm this configurations Sit 6 becomes TAI4 
and bit 7 pecomes TA17. Thuss when doth fits are tows, RAM bank 9 its 
selected. When oit 6 is highs WAM bank 1 is selveted. Fit 7 high and & 
Low selects RAM Dank 2% ana voth high selects RA*® dank 2%. At the 
present no simple way has seen defined to turn off RAM selection for 
holes Like the FFO0 to FFAS 4*%U registers with this method of selection 
as there was with CAS steering for the 122K MMU. Regardless of the *4U 
versions the raset configuration of soth of these is zeros selectins POM 
gank Je The schemes of exteandeq addressing used here are also used for 
Page Zero and Paye One offset anc for VIC oank selection. 


SBehekc THE PRECONFIGURATICN MECHANISM 


The oveconfiguration mechanism is a feature of the M4U that allows 
the Configuration Register to be lLosadecd with one of several memory 
configurations with a nininum of time ana menory on part of the usefe 
The scheme makes use af two sets of registerss the PreConfiguration 
Registers and the Load Configuration Reaisters. 


The PreConficuration resisters CPCPA - PCRO) are used to store 
several different nemory configurations that may be changed detween with 
a single store instruction. The foraat of each 9C? is the same as for 
the CRs» put when a value is stored to a PC2r no Immediate effect takes 
place. They occuosy I/70 soace from $0571 ta $9554, These resisters 
always reset to all zeros. 


Load Confisuration Fesisters (LOIPA - LCSD) directly corresoond with 
the PCR on a cone to one oasise A write to an LCR causes the contents of 
the corresponding PCR to oe transferred to tne CR. A read of any LER 
returns the value of its corresponding PC2. LCR*s ara Located in system 
space from SFFG1 to SFFQ4. Neither the LCR's nor the PCR's have any 
effect in C4% mode. These registers reset to all zeros. Note that 
these and the configuration register at SFFOU will always be available. 
completely independent of the ROMs RAM, of Bank configuration defined 
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for HI R20™ spaces any address in this france causes the MM to force both 
memory status lines ana both CAS enable Lines high. 


6e4e3 THE “MODE CONFIGURATION REGISTE® 


The control of the current system moce is a30vernegq by the *Yade 
Configuration Rezister (MCR). It controls which processor (€3509 or 236) 
and which operating system mode (C44 or C7123) jis currently in 
operations ana nrandles other overhead of the cifferent onerating modes. 
This register is loacatea in the I[/9 space st £05595. 


The first tits bit S- controls which srocessor is in control. It 
is usually seen inverted as the outout signal /Z20EN. «hen lows it 
indicates that the osrocessor is the 3562. This is the reset 
configuration. dnen hijgn, the 250 oarocessor takes overs and all 
access®#s ta memory from $9900 to fSFFFs is translated to £9090 to SOFFF, 
where tne CP/M ROM SIDS physically exists in ROM. A change to this bit 
is hela in orelatch until 1 clock transition in oraer to prevent 
perocessor chanjging in the saidst of an instruction executione For Z75C 
BIOS operation tne memory status lines “350 and M351 reflect systen ROM 
Cboth low) for accesses from JCIF to TFFF., otherwise they will both oe 
high. PAM can still be ranked by the A116 sits which controls CASO and 
CAS1. Note that tn C64 mose the s/ZTEJEN Line is forced low regardless of 
the value of this bit. 


8its 1 and ¢c are unus2eds dut are reserved for future expansicn as 
port lines. Currentlys they return high if reads and cannot be written 
Co. 


Bit 3 is the FSOIR control bit. It 1s used as an output to control 
the fast serial disk gata cirection suffer hardwares and as an input to 
a sense fast disk enable signal. The M4¥U pin FSOTR reflects the status 
of this bits which is reset to zero. This register bit is implemented 
as a bidirectional port, similar to a bit of an MOS 6529 port. The 
value written to the port effects the outout polarity and the value that 
will be read unless the port is driven low externally, at which time it 
wilt read low. If the external driving source is removeds the bit will 
then resume its orevious state. 


Sits 4 and 5 are the /SAME and SEXPOMIN sense bits, frespectively. 
They directly reflect tne hardware cartridge control Lines /GAME and 
JEXROM as used in C64 mode. They are not used by C-128 cartridges, so 
if they are detected in C-1c5 modes, a C64 cartridge is present and C64 
mode should be assertea. These bits are aefined to be bidirectional 
bits which act very much Like the bits tn a 6529 ports jieees a value 
written to the bit effects the output polarity of its corresnonding 
hardware line and the value thatwill Se read from the ait unless the 
port is driven low externally,s at which time it will read low. If the 
external driving source is removed the bit will resume its previous 
State. The /GAMPZIN bit is used as an output to control the banking of 
color RAM that permits split screen graphics in C128 modew The sSEXROMIN 
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sense bit has no dedicated output function at the present time. 


The operating system mode jis set ny the next dit,» bit £. This bit 
is cleared to zero uoon reset and its presence enadles all “MU registers 
and other C-128 features, as well as asserting the C-122% control line in 
hardware. Setting this oit removes the M“U from the memory nap and sets 
the systen up in C04 modew ‘ote that the C-123/¢44 (S53) hardware tine 
reflects a lLosical inversion of the Level of this tite 


Sit 7 is a readmonly cit used to detect tne status of the screen 
moce switchs as aresented in hardware to the 46/790 column oin. If this 
bit is higns the 40750 column switch is ooens if lows, tre switch is 
closed. The disolay mode is set according to a software interpret3tion 
of this sit. This soit is also available as an outout dits similar iin 
characteristics ta tne J/GAM“EIN and J/EXVIWIN vsits,s but its output 
function is undedicated at this time. 


Ge4e4 THE PAM CONFIGURATIAN IEGISTER 


ee The RAM Configuration aeyister sets up the Ray sesmenting 
parameters for poth the opracessor and the block pointer for the VIC 
chipe This register is Located in tne I/0 space at $0506. 


Rits 0 and 1 function tosether to cetermine the size of the RAM ta 
se shared detween Sanks Cassuming that sharing ts enabled). With common 
RA“s the RAM bank cits of the configuration register are basically 
Overriddens as the selected cank of 3A" is used for the non-common 
areass while sank 2 is used for the specified conmon areas. RO” and I/C 
block configuration bitss however, are still imoortants, If the value of 
the bits tonether is Cy then 1K of PAY 315 held common. [f the value is 
le then 4Ks 2s, than 2K, 32, tren 16K. These bits have no effect in C64 
modes, ana the reset value of both sits is aefined to be zero. 


Sits 2 and 3 function to aetermine how and if RA" js kept common. 
If both are tows no sharinz takes place. If vit 2 is sets tha bottoan 
RAM is sharec. [f 71t 3 18 setry the too 2A" is shared. S3oth may be set 
for sharina in top and bottom. The reset configuration sets both of 
these bits zero, such that %o common memory is presente. For the 122X 
MMU, the selection of the common memory is Gone by forcing CASD Low and 
CAS1 hign for all common memory accesses. In the 255K MMU, accesses t3 
common memory must de translated to access only dank 0 RAM, 


The next two bitss numsers 4 and 5, are not used presentlys but are 
reserved as block pointer sits for addressing uo to 1 megadyte af 2AM, 
in 256K olocks. Taking 5 ana 4 together as a numbers 1f they are set to 
zeros dstlock 1 adis- in effects if 1 plock 2 is in effects and so sane 
permitting four oslocks of 254K to de selected. The oresent MMU does 
nothing with these bitss they always return low when read. A future “SMU 
may take advantage of the extended bankine that these bits provide, but 
to do sos two pins must oe freed. Currently, the A&s/AS and AS/JAZ inouts 
can become one AGJAS/AS5/A7T jnouts freeing one pin. The other pin to be 
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freede will be MUX. The MMU bonding schene wilt allow for these 
aformentiaoned pins to become A13 and A119, 


Bits 5 ana 7 function together as a RA® block pointer for VIC. For 
the 127% MMU, bit 7 is ignored, while bit 6 is used to drive CASO low 
when set low or CAST Low when set high, thus selecting either RA bank 0 
or RA“ bank 1. A <50K “MU selects the bank by bringing out sit S as 
TAI14S and hit 7 as TAI7.}’ Either scheme allows the VIC to be selected 
independently from the oracessor bank. When in 24Hz mode the S0-column 
chia takes over causing the VIC to be diswanled. The disaolinga is 
affected by the VIC chip itself holding AEC constantly hiahs, and thus is 
not directly affectea by actions cf the “YU. Note that since a VIC 
cycle is detected by AcC lows that any OMA will put the MMU into VIC 
configurations as it too brings AEC low. In future systems «ith 
multiple 256K slockss the VIC chio will ve able to access RAM in Slock 9 
only. 


6e4.5 THE PAGE POINTERS 


The oage pointers are four reaisters that allow independent 
relocation of pages zero and one when running under either processor. 
These are esosecially useful when runnins under the 8502 as they helo to 
remove some of the zero nage and stack Limitations normally associated 
with the 6502 family processors. 


For zero pase relocation the MU provides the Page Zero Pointer 
High (POH) and Page Zero Low CPOL) resisters. its J and 3 of the POH 
register correscond to translated address TA1S and TA19s respectively, 
for any pase zero access ($9090 - BSCOFFI. In the 128K systems Dit © 
cantrols the generation of CASO or CASI deanending on whether it is tow 
or highs nad bits 1 to 3 are ignored. In a 255K system Sits 0 and 1 are 
directly translated to TAIS and TAI7 and bits 2 and 3 are ignorec. In a 
1 Megaoyte extended systems Sits 2 and 3 become extended addressing bits 
TA13 and TA19. The remaining bits will always return zero. These obits 
override the RA% oank bits. The 90" blocks and the I[/0 block bits 
determine which physical sage anpears as zero page for atl zero page 
accesses. A write to the POH register is stored in prelatch until a 
write to the PQL register occurs. 3i1ts 9 to 7 of the POL correspond to 
Translated Addresses TA®% to TAIS for any zero page accesss thus 
relocating the zero page. Any access to the area that has become the 
relocated zero cage is switched back to the original zero pagee A write 
to this register sets uo tne zero page transfer, which can occur as soon 
as the next Low clock cycle. Register PIL is located in the I/0 space 
at $0507, while register POH is Located at $0598. 


The registers for page ane relocations the Page One Pointer High 
CP1H) and the Page One Pointer Low (PTL) do for page one essentially 
what POH ana POL do for the zero oaje. The functions and bit 
correspondences are exactly the samee PIL is located in tne I/70 soace 
at $0599 and PIKH at 3D50A. Note that both register pairs are 
initialized to zero upon resets, forcing true page zero and true page one 
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accesSe 


Ge%eS SYSTEM VERSION REGISTER 


The final register discussea here is the System Version Vegjister,s 
which is tlocated at 3950H in the I/0 block. This register is a 
read-only resister that returns a code containing the version of the MU 
and the size and capability of the system's nenorye Tre Lower nydoles 


bits 9 thraousgn 3 contain the version of the “4*U tn the system. The 
upper nybole, osits 4 through 7- contains a code relating the number of 
memory olocks availaple in the system. This allows softsare to 


compensate for any Later systems with more memory availables and should 
make it quite simole for the current C-12° to remain compatiole with any 
software written in the future for an expanded C-123. The initial ¢c12é 
will read 2 2 neres indicatina two 44K blocks are availanle. A zero iin 
this nybole weuld tndicate sixteen $46K blocks. 


Note: For a ohysical description ana ““U ain Layout and 
definitionss aosolute maximum ratingss operating conditions refer to tne 
4" specification. 
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CHAPTER 7 


KERNAL JUMP TAELE 


C464 MODE AND C123 MODE KEQNAL JUMP TAALE 


HEX 


AODRESS 


FFS3 
FFS6 
FFS9 
FFSC 
FFSF 
FFL2 
FFAS 
FF6S 
FF 63 
FF6E 
FF? 1 
FF?S 
FF?7 
FF7A 
FFT 


Vectors for C122 


VecTOR 
NAME 


poot_call 
ohoenix 
Lkuola 
lkuos4 
Swaooer 
atechr 
ofkey 
setdnk 
jgetcfa 
jserfar 
jmofar 
inafet 
indsta 
Indemp 
orima 


FUNCTION 


,000t Load program from disk 


,call alt function card's cold start routines 


search tables for given la 

search tables for jiven sa 

,Swap to alternate display device 
zInit 39-col character ram 

program function key 

set bank for load/save/verify 
ecaonvert oank to mmu configuration 
,33R to any banks, RTS to calling bank 
zJ*P to any sank 

ZLOA Cfetvec)/-Y from any bank 

2 STA CstavecdsY to any bank 

2C¥P CeomovecdsY to any dank 

,2r° int imnediate 


Ceditor) 
Ceditor) 
Ceditor) 


Calways JSR to this routine!) 


KERNAL JUMP TABLE Page 7-2 
C64 vectors 
He X VECTOR 
ADDRESS NA¥E FUNCTION 
FF20 ebyte VU ePelease number of kernal 
FER] cint zImMit screen editor 4% disalay chips Ceditor) 
FFSG Toinit init ifo devices (ports, timerss etc.) 
FFR37 ramtas einitialize ram for system 
FFS3A restor ,restore vectors to initial system 
FF 20 vector echanse vectors for user 
FFSQ setmss econtrol oeSe messages 
FFIOS secnd ,senad sa after Listen 
FFIS tksa send sa after talk 
FF9O9 memtao eset/read too of memory 
FF9OC membdot -set/read bottom of memory 
FROF key scan keyooard Ceditor) 
FFA2 settmo 7S2t timeout in jeee 77779797997 Unused 779777999997 
FFAS acptr shandshake serial byte itn 
FFA3 ciout shandshake serial byte out 
FFAS untlk 7s9Ad untalk out serial 
FFAc untsna r,sena untlisten out serial 
FF31 Listn send Listen out serial 
FFRA4 talk send talk out serial 
FF27 readss zPetur\n 1/0 status byte 
FFSA setlfs 23et lLavsfas sa 
FFoO setnam 7s9t length and fn adr 
FFCU open zooen logqicalt file 
FFC3. close close Lojical file 
FFCS chkin 2zaonen channel itn 
FFC9 ckout 2open channel out 
FFCC clrch 2zclose i/o channel 
FFCF basin zinout from channel 
FFD2 osout -outout to channel 
FFDS Loadso zload from file 
FFD3 sSavesp esave to file 
FFDQ settim set internal clock 
FFOE rdtin zread internal clock 
FFE stoo scan stop key 
FFES getin 7zjet char from queue 
FFE? clall eclose all fites 
FFEA clock zincrement clock 
FFED jscrorg return screen size 
FFEQ jolot ,read/set xsy coord Ceditor) 
FFF 3 jiobase return 1/0 base 
FRFA FFQOS 2,1 
PFFC FF 3D reset 
PRRE FFT? if a 


CHAPTER 8 


OVERALL DETAILED SYSTEM MEMORY MAP 


There are three memory amaos shown on the following pagese The maos 
includes 1.) C128 SASIC “AP, 2.) C123 DISPLAY MAP and 3.) C128 2AM MAP. 
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Bel €1283 BASIC MAP 
a brief explanation of the pointer structure in basic: 
RAM bank 9 RAM bank 1 

FFFF | seen ------ mmm SS CMAX_ MEMO) 8 | eormmen meen nnn nn | <= (MAX MEM 1, 
| I l i 
| | | | 
| Free RA i | Strings j 
| ; l | 
| j | | 
| | | PSseneeeoeaaas | <ese (PRETO?) 
| | i | 
| --2--------- mm] <Sa(TEXT_TOP) | 
| | | | 
| | l 
i | | | 
| Text a 3fea j | | 
| l | poet n nnn enna | <== (CS TREND) 
| | l | 
| | | 

GQQ0 Seed | meer w enn nme nnn | <=\ i Arrays | 
| \ | | 
J} sit “apoed | | } 
| Sereen {| (TXTTAS) | | 
| CSometines) | | mamma mn an | <e== CARY TAR) 
}€Cand color 2A) | / | [ 

C90 ss=> | recor oreenccce |}<=/ I | 
| | | | 
|} Mise. Buffers | | l 
i | ( 

1090 ss=> | omen cow nen e em | i | 
| | | Variables ; 
| Misc. Var's | | [ 
| | l 

0300 s==) | “22s en rrr ere | | i 
{ | | | 
| Text Screen | l | 
| | | 

N46 00SS=> | mm mo wow nn oor r ern | Casa Ss sss ssssa> | eee ree wm nm | C2 Sa (VARTA, 
| i 
|} Common FRA” | | Common RAM { 
| | | 

900 | | I | 


1. * indicates a new pointer. 
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(#1) 


(#2) 


3) 


TEXT 
MODE 


Text color 
info. 


Not 


used. 


Not 
used. 


Text 
screen 


C128 DISPLAY MAP 


HIRES 
BIT-MAPPED 


Sit 
map 
screen 


bit~mapoed 
color info. 


Not 
used. (#2) 


MULTI 
SIT~MAPPED 


Jit-mapped 
color info. 


Bit 
mao 
screen 


Bit~-maoped 
color info. 


Not 
used. (2) 


Text color 
info. 


97t 
map 
screen 


3it-mapoed 
color info. 


Text 
screen 
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Text colors (#1) 
8M color info. 


Bit 
mao 
screen 


3it-manpped 
color info. 


Text 
screen 


There are actually 2 banks of RAM that can be mapoed into this slot in 
the map. By selecting ane bank during the 3it Mapped portion of the 
screen (top)s and the other during the TEXT portion of the screen 
(bottom), each mode will have unique RAM for its own purposes. 


Although the information on the TEXT screen ts not actually being 
displayed at this times it is still being accessed and updated during 
any operation normally routed to the screen (such as default print 
Statementss error messages, etc.) “Not used” is NOT meant to imoly 
that during this sodes all print operations are going into the 
bit~bucket. 


Text mode requires 1000 character pointer for screen datas and 1000 Low 
bit nybbles for foreground color. 
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4) Hi-Res mode requires 8000 bytes for the dit map screen and 1000 oytes for 
foreground and background data. 


5) “ulti-color bit map mode requires 30090 bytes for the oit map screen and 
2000 bytes for multicolor data. 


6) Hi-Res split requires the same memory as Hi-Res plus the memory normally 
used tin text mode 


7) Multi-split requires the same memory as Multi Color Bit Mapped Mode plus 


the same amount of memory as text mode. Per note 1 above separate memory must 
be used to separate text color nyodbles from the multi-color rode nyboles. 
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C123 RAM MAP 

SOACGU2 | So 9S=2<SSe4e4eS—= j 
( 

| i 

i Pasic | 

| | 
$090u>] Run-Time | 
| | 

| Stack j 

| 

| 

| 

$0800 | ~we eee eee ere=-- | 
| i 

| | 

| ! 

| l 

| vic | 

| Toxt | 

i Screen | 

| 

| (vat) | 

l | 

| 

| . | 

l i 
$0409> | w2- ee ee ee ee i 


| 3Sasic RAM Cade| 
$03 80>] 


$033C>] ~- - 7-270 | 

$0 2F CO) | Ss99Sss<<======] | 

|}Kernal RAM Code] 

SO2ZA8>{ -- -- -- - 

}8asic % Manitor| 

{ Inout j 

suffer | 

$0200> | seer reer en ---- | 

| System Stack | 
$01469>| ~- 7-7 e+e+ 


| 
{8asic DUS,/USING| 
$0110>/| 


FSUFFER 
S006? [eeere tase aee== | 
| 
} Kernat 2.P. | 
$0090>| -~------ | 
| S8asic Z.P. | 
$O000>]_2 | 
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$1390) | ee wee eee rer cor= | 31C00>] 
| Qasic | } 

i Adsolute | i 

| Variables | i 

| | 

$1290D | en meme ewe eeenn= | $1350>] 
| | | 

| Sasic | { 

| DOS / VSP | i 

| Variables | | 

| 

91190 | ewer n eee eeee=-—- } 31AQ0C>] 
| { 

| Function | | 

I Key l 

| suffer | | 

| i I 
$1000) | worrensreso--= --| $1900>] 
| ( | 

| | | 

| | 

} Sprite j | 

| | | 

SOF O0> | Definition | 3$18C0>| 
| [ l 

| Area | | 

i | I 
59E00D> | eer e renner ere--- } 31709>] 
I | | 

| RS-27%2 i | 

i Output } { 
9uffer | i 

$0D009> | meee www ene eeno= | 31500>]| 
| | | 

! RS$~-232 | | 

| Input | { 

| Puffer | | 

| | 
SOCOU>D | wr eee seer eeree== | $1500>| 
| | 

i | | 
$93C0>] ---*f-f7re-7e-°0 ; | 
| Cassette | | 

| Suffer | | 
$930Q> | eee ere wee errr { $1400>] 
i Monitor 3 | | 

i Kernal | | 

{ Abdsolute | { 

| Variables | | 
$0400 | seer eete nse {| $1300>/] 
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Availaole 
For 

Function 
Key 


Software 


RESERVED 


RESERVED 
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SFFFFD>| --------------- 
SFF8Q>)] CPs7™ 2A4% Code | 
|} Kernal Interpt | 
[ RAM Code i 
SFFOS> | eoee row eeeren= | 
| ale 
SF FOO> | ----2---- ------ 


gasic 


Text 


Area 


CPasic Text 
besins at 
31¢0u> 

Tf sit~Map 
unallocated) 


$4000>| 


VIc 
34 t-Mao 


Screen 


| 
CVNH2) | 
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CHAPTER 9 


DETAILS OF SOFTWARE INTERFACE TO 55493 €30 COLUMN CHIP) 


Jeol OVERVIEW 


The %VJ-column chin intecrates several features that are oresently 
jamplemented with a $6545 and a large number of TTL oackagese. The 
80-column text display chip is designed to work tike a SS45E 
CrT-Controller. To fully understana the features of the chips refer to 
the 856% DESIGN SPEC (2/10/24) for the oin and register layouts. 


The CPU interface (CON-D7, Phasemes2/Ws RSs €3) Pemains the same as 
the 6545¢é. The LPENs FESs HSYNC and VSYNC pins also remain the same. 
The disolay RA* Address lines are extended to 16 bitss and are 
multiclexed onto 8 #=pins in an address~mlowsaddresswmhigh configuration. 
Timing signals 2AS and CAS are output to drive dynamic RAMs. A CCLOCK 
output is generated to allow this chis to supply a phasem2 signal for 3 
processor in a shared memory addressing canfiguration. The DISPLAY 
ENABLE outnut pin performs the same function as before but now has 
programmable location and suration. 


A single Disolay RAM interfaced to the @0-column chino serves as 
storage for character pointers and character datae An 80-column doudle 
Line buffer is inplemented on=chio for both character pointers and 
attributes. The chis has an output pixel shift register. An 3 bit 
Disolay Data @us is used to transfer data to and from the Display RAM. 


The Display Data Sus has several uses: to transfer C°U data that 
is passed transparently through the &C-column chips to transfer 
character pointers and attributes from the Display RAM to the on-chip 
Line ouffers and to transfer character cata from the Disolay RAM to the 
on~chin shift register. 


Four video outputs reflect either the fourmbit character foreground 
attribute, the background register bits or the foreground register bits 
Cif an individual character attribute is disabled). A high speed Dot 
Clock (OCLK) is used as a clock input. 


ALL the registers of the 6545€ are implemented exactly the same an 
this chip with the exception of Register 3 (Mode Control): Sit 7 is not 
used as well as bit 64 bit S and bit 42 New registers are needed to 


- Si - 


DETAILS OF SOFTWARE INTERFACE TO 8563 (50 COLUMN CHIP) Page 92 


jmaplement new functions. (These reaisters can be found in detail in the 
8563 Specr as well as timing diagramss sequencing of display memory bus 
accessess ORAM timings and AC parameters for the 32563). This spec is 
not intended to caver those oarticular areas in detail. 
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CHAPTER 10 


CP/M MODE 


10.1 GENERAL SYSTEM LAYOUT 


The C-125 is a two processor system with the primary orocessor 
being the &8&5C9 and the seconcary orocessor deing the 280. The 8500 has 
the same jnstruction set as the 6502. The €7123 powers up running SASIC 
using the &5C9. The 220°s crimary function is to run CP/M Plus. This 
chapter relates to the requirements, methods and solutions for 
imolementing CP/4% Plus within the C7128. When CP/™ is runnings the 
normal functions of the C1283 are not sunoorted (CP/M and S8ASIC cannot 
mun at the same tiae). CP/"% does not directly support all of the 
display moaes of the VIC chin Can application could be written to run 
under CP/M that could use the extra agraohics capabilities, but the 
application must keep track of all the details such as memory maps). 


By providing for C7123 is increased ty many fold. 

There are a number of system parameters that are configurable by 
running a configuration orograme. Following is a List of options that 
are selectable: 

1. RS232C KON/XOFF on receiver enadled disabled 

2a RS2352C XON/SXOFF on transmitter enabled disabled 


3. Number of disk arrives 


4. Type of printer(s) connected 


10.2 SYSTEM MEMORY ORGANIZATION é 

The memory map is Limited to 64K at any one point in tine. 
However, the YAM bank can oe selected and then different ROM areas can 
overlay the RAM Cwith bleed=thru on write Lines). The actual memory aap 
1s controlled by the M4U. The MMU can be accessed in the I/0 area or 
through the Load configuration registers located at FFOO through FFO4. 
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If 


aMU, 


weitten. 


D500 
D591 
0502 
D503 


0504. 


05905 


0506 


0507 
0508 
0509 
DSQA 


the 
reade 
current 


A write to FFOOQ changes the confi juration 


CF FOO) 
CFFO1) 
CFFO2) 
CFFQS 
CFFOS) 


“Mode 


RAM Configuration Resister 


Page 
Paje 
Page 
Page 


Configuration Register 


instruction. 
configuration to the value 
data written is not used). 
and a high (page) pointer, 
the high 


value 


Peeconfig 
Preconfig 
Preconfig 
Preconfig 


Configuration Yeyister 


2 2 GC) ©) 


* denotes not 


Pointer 
Pointer 
Pointer 
Pointer 


in C123 


A write 


Is updated 


Register 
Reqister 
Register 
Reaister 


Low 
HIgh 
Low 
High 


imolementation = 


A 


3 
C 
9) 


7 417 
fe) A116 
5 ROM 
4 eo 
3 RO™ 
2 QQ™ 
1 ROM 


C T/0 
40/3 
Os 


JoAM 


wm eE& Un NI 


(res 
Cres 
Proc 


oan 


VA17 
VA16 
RAM 


Wi KAN 


& 


RA™ 


Shar 
Shar 
Shar 
Shar 


OO — re Ud 


Hi 
XXX AMX 
L9 
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load configuration registers are read then the current value is 


after comoleting the 
to FFO1 to FFIJS updates tne current 


RAM 3ank = 
QA Sank - 
HY glock = 
HI Block °=- 
MIO Slock - 
MID Alock = 
LOW f&lock = 


Rlock 


So Sense 


ode 


JEXROM Sense 


E Sense 


Fast Serial Port 


erved) 
erved) 
Mode 


stored in the preconfisauration registers (the 
The M#8U page pointers have both a low (page) 
the high is written first and latched in the 
from the Latch when the low byte is 
The MMU control registers are as follows: 


reserved 
2 ee | 
OO-System ROM 
CI*INT Func RF 
TO-EXT Func Rus 
11-9 A™M 
O-System ROMs 
1-RA™ 
O-System I/G. 
1-HI ROM 


9-C1284 17Cé 


O-Data INes 
1-Data our 


9-8590- 1<Z3u 


= VIC RAM SANK 


slock = 
Alock = 


ed RAM Tap 
ed RAS 3o0t 
ed RAM Size 
ed RA Size 


ah Pointer 
XXK MXX 7977 
w Pointer 


09 0-256K~s 

01 256K=-512K 
10 S12-763Ke 
01 768K~1*" 
O-Nos 1-Yes 
O-No, 1-Yes 
0071 K,07—4K 
10-8K411-16«K 


777 A17 A116 


A1S A14 A13 A12 A141 A10 AO? ADE 


54 = 


reserved for future use 
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COMMON MEMORY MAP 


Ad 


$eweone $e e=m $oem==- $e om m—= + $ommnwnn poem -ee powew—— pommome > wwe own y 
| | | [ | }38KC128] Func | Fune | 8K fF SK f 
FCO0] ] ] | { IKERNAL] INT [| EXT [€C64) |] GAME | 
| | | | | IML MONJHI ROMIJHI ROM|KERNAL] CARD | 
E000] i j $ -— = =~ = = —+ = — fe mmnn a4 cnn wn—+ 
| | | | | I/O & CHAROM j 
0009] | | | et 
| | | { PKERNAL] Fune | Fune | 
C009] | i | { $2 $e +m $ommnmo= $ocoere— + 
| i | | | { | | { 8K | 3K | 
8000j | j } | } 22 K | Fune | Fune |B3ASIC [Lange | 
| | | } BASIC | INT | EXT | 2.2 | Card |{ 
AQGO| rR of oR ' oR | R { } 3.x | | + were s+ oer ~——+ 
| A | A | A | oA | | | | | | 3K | 
9000} mM | ; { ! [| CHI) | LOROM JLOROM | JExtens|]| 
| | | | | } | | | } Card | 
8000] 3 | 3 { 3 | 8 | tome eee -oww@eo p-owocwe + $ocrere- + 
A | A | A | A | 
7000] Nf ON | oN } oN | } 32 K | [ | 
K | « } XK | «K | jaastc ] 
6099 | [ { | | 3x | { | 
| 9 | 1 Ii. | 3 | | | 
5000 | | l | | } Low | | | 
[ | | l ( 
4000] | ; | | Peas = + | | 
i | | F |< | 
3000} { } YU | Xx | | ! 
| | T {| P | 
2000 l | U | ae | | | l 
| | R | N | 
1000| | i E | S| | | | 
| { | | | 
0000 +22-2--<-— $m ecemoe $oorewo=ee ¢$ownmcore + | | ] 
| C128 | C54 | 
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102.222 230 MEMORY “AP 


780 Memory Map 


FRR F been ene 2 nnn nn nn nn oo nn = == + 
| M“U and 8890 reserved area | 
FEFOQ tree er ere eer ee wees oeorer== cases + 
| j 
| j 
| Common 
| e00S & AIOs & $C3 | 
H | 
2000 +<<———— ee $ommewnnn woe $c eeewwwe + 
| | i | 
}Banked|] ! | 
} e805 | | i 
} os | { | 
} ares | | | 
| | | 
2900. Fo sos + | | 
| | 3 | | 
}ccP | ) } 127 K [ 
jolock | K | 
i 2 { i l 
[ | | | 
1300 t¢<~----~+ | Re aM | 
| | i | 
J} vic | i | 
1SCREEN | T | ° | 
; { P | | 
19090 +<--<---= + A | 0 Is X | 
| j | i 
0100 | CP/™ +__ + i 
ISANKED] | Cfuture expansion) | 
1 ROM | cps | 
} COOE | page 9 ] | 
| | | | 
0000 +—----=-- ee $e eewn none $owoee oom + 
dank 2 1 2 3 
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102223 8500 MEMORY MAP 


8500 Memory “39 


FFE F te2enn-n-= $ enw nnn $22 wwe eee Se + 
| MMU IMMEDIATE REGISTERS | 

FFFQ ¢eee tr e---- $<<---- wows t+erese=--- +o er eee--- + 
| | | | 

| Kernal Jj ccP | 

} RO |} tlhock 1 | | 

| | | | 

E000: t=s==+s<<= $oweccew=— + 
| | | | 

1/9 

| | | | 

POCO Fi + | ! 
| | 3 | | 

} Kernal | 9 | 127 XK | 

| ROM K | 

} Ccont) | | | 

| | | 

COOG: +=<<ss-=-= + | ] 
| i | 

| 3anked | | i 

} 8905S | | | 

| 3 | | 

} 3108 | 

2500 “ts==s==ss= + | 
| | I | 

coe RAM 

} oslock | | ! 

| 2 | | 

1200 t=<Ss=-<s> ~ | | 
| | T 

| Vic | P | | 

[| SCREEN | A 

| | | l 

1000 +-e<e----— + { | 
|. orsK | 

| BUFFER | | DIsSkK 

JEOC: t4s<<<<<-= + | | 
| | |} (future expansion) | 

| $85c0 | | | 

| eros | 

| | | | 

0400 +-22------ $e nem ween $+ mewn eee $row en-eoe + 
| Kernal | 

RA ' 

0100 +t--------- $oeenne--— caceecones jc UsesSaue + 
8509 i 

| Page 0 | 

JOU0 4ss-sS<<== toweerer-- $omeeeno== oe + 

Sank 8 1 2 3 
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1023 1571 DISK ORGANIZATION 


CP/M Plus supports many different diskette formats. The first 
being compatible with CP/* 2,2 tnat runs on the C64. with this format 
the File Control 3lock (FCS) is set up as 32 tracks of 17 sectors each 
and a track offset of two. The 8IOS routine adds a1 to tracks aresater 
than 13 (this is the C64 directory track). The second format is new and 
takes advantasze of the full disk capacity. This ts done by setting uo 
the FC@ with 63& tracks cf one sector each and a track offset of one (1 
sector). This has the effect af naving CP/M set the track to the block 
number relative to the beasinning of the cisk with the sector always set 
to zero. The following salyorithm is usea to convert the requested TRACK 
to a real track and sector number. 


The remaining formats require that the user have the new 1571 aisk 
drive. This disk drive supports both single and double sided diskettes 
and both the Commodore GCR and industry standard “FM data coding 
formats. The third GCR format is double sidea. The aisk is treated as 
1276 sectors of data witn a track offset of onew Side one is used first 
then side two is used. 


Note: This is not the normal way to handle a two sided disk but by 
allocating the disk in this manner the user with a 1541 may still be 
able to read sata written at the start of a two sided disk. 


Effective Track (1°35) = INTCFunction) 
Effective Sector (0-29) = “O0CFunction) 
Block Number Function Region 
399 >= THACK > 3257 CCTRACK=000-0)7/ 21) +01 1 
357 > TRACK > 4995 CCTIAC K~=35 7719/19) 413 P 
4696 > TRACK > 593 CCOTRACK=490—-1 2/78) 4%25 3 
$93 > TRACK > 433 CCTRACK~598~-1)/17)431 4 


The effective sector is then translated to arovide a skew that 
speeds uo operations. The skew is used only with the new Larger format. 
A different skew table is used for each region of the disk. 
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Notice all of the unused space. 


Sector 


8 
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C64 CP/™ DISK FORMAT 
This format is provided to maintain compatibility with the C64 CP/™ 2.2 


system currently on the markete 
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D 
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D 
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Used by CP/M 

Boot Sector (System) 
Directory Sector 

Not used by CP/M 


3 
D 
x 
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C-123 CP/M DISK FORMAT 


10.362 


Disk Format 


C123 CO/Mm Plus 


Sector 


Cc) 


5 10 11 12 13 16 15 16 17 13 19 


5 4 7 § 


4 


ae | 


QeNM FCM OK CO MH 


= regioan(1-4) 
Boot Sector (System) 


Used oy CP/™% » Fege 


3 


@ TABLE 


= 
— 
Gap 


aK 


910 11 12 13 14 15 16 17 18 19 20 


: 


7 


») 


03 14 07 


6$ 16 09 02 13 06 17 10 


05 01 13 14 10 06 02 19 15 11 97 03 20 16 12 908 04 
14 04 11 01 08 15 05 12 02 09 16 06 13 93 10 


200 04 03 12 16 01 05 09 123 17 O02 96 10 14 18 03 97 11 15 


3 00 17 04 15 C8 UT 12 
00 07 


190 17 13 Q9 


A 
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10.4 MFM DISK FORMATS 


The following disk formats will be puilt in and selectable from the 
keyboards: OSSO0RNEs, KAYPROse EPSONs and I8M CP/M—36,. Other formats will 
pe available and selected Dy runnina a configuration programe. Tne built 
in formats will de selectanle from the keyodoard oy using a special key 
sequence. 


The I3" C°O/M—86H caoadility itis provided so that data can de 
transfered between machines. we cannot run C2425 orograms on the C123 
CCP/M Plus 718 FUNNINg on a Z20 not an 3062). 


OSBORNE Csingle sided only) 


KAYPRO 
Sinacle sided 
Jouble sided 


EPSON 


Id CP/%-36 
four different formats 
sinale sided @ sectoarsstrack (S3~-2) 
Single sided 9 sectors/track (SS-9) 
Ooutle sided 3 sectors/track (05-5) 
Double sided 9 sectors/track (0S-9) 


$s7-8 (Im) 
40 tracks/side 1 side 
3 sectors S12 pbytas sectors/track 
1 track offset 
1K allecation size 
04 directory entries (2 allocation units) 


S$S-3 (13M) 
4Q tracks/side 1 side 
9 sectors 512 Bytes sectors/track 
1 track offset 
1K allocation size 
$4 directory entries (2 allocatian units) 


OS-2 (ia) 
49 tracks/side © sides 
® sectors 51c bytes sectors/track 
1 track offset 
2K allocation size 
64 directory entries (2 allocation units) 


OS—-9 C(I3M) 
40 tracks/side 2 sides 
9 sectors Sid bytes sectors/track : 
1 track offset 
2K allocation size 
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84 directory entries (2 allocation units) 
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10.5 MEMORY OISK ORGANIZATION 

The “Memory Disk will only se avajlable in systems that support 256K 
of OPAM, System utilities allow the user to generate a system with or 
without the RAM aisk. The RA” disk file control block CFCS) is set uo 
as two tracks each with 598 sectors of 128 Dbytes. The track then 
becomes the bank and the sector is an offset. 

This “emory Disk should NEVER use any LAU blocks (CP/M uses LRU's 
to vdouffer aisk sectors the method used in maintaining these buffers ts 
called Least Pecently Used (LRU. This wastes memory by duplicating 
copies of sectors in memory. This is also the reason for using 123 odyte 
sectorse Larger sectors require bStlockins/aeslocxing LRY block. 


NOTE: This 38 not cart of C122, maybe future C2564 also possible 
external OMA RA” disk. 


10.5 CODE ORGANIZATION OVERVIEW 
The 8500 and 230 share many of the low level FUNCTIONS for CP/™ 
Plus. This 1S Gone to ootiniz?® the soeed and code requirements. The 
following functions are performed and are defined within the following 
sections. 
1. 3o00ting of CP/M Plus 
2e “Keydoard scanning 
3- Uodate 40/80 column display 
‘he Printer interface on serial bus 
Se Get a char from 25272C adapter Cwith XON/XOFF) 
6-. Send a char to RkS232C adapter 
Ve Read a sector of data from disk (fast and stow) 
8. Write a sector of data to disx (fast and slow) 
9. Reaa a sector of data from the RAM disk 
10. Write a sector of gata to the RAM disk 
11. Format disk 


12. Copy CCP to Hidden RAM from TPA 100H 


13. Copy CCP to TPA 109H from Hidden RA™ 
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14. Set system time 
15. VUodate system time 


156 “emory to memory move 


106601 3LOCK TRANSFER OPERATIONS 


There are three different types of block ocerations that aust oe 
performed. These are Disk sucdorts RAMA DISk Supports and moving the CCP 
to and from a holding suffer. 


The 72393 has a routine tnat can nove data from any address and oank 
to any other adcress and sank (nonwoverlanasing). The routine relies on 
the fact that the “MU pace 3 and page 1 can se pointed t9 any oage 
soundary within the system. This routine uses th LOI? instruction but 
must break down the transfer inte noves of 250 bytes or Less. This 
routine is a major routine in the jevelopment of the CP/M Plus system. 
ALL other routines use tnis routine to do olocx moves between oanks. 


There are two types of aisk drives for the (C122. The Commocore 
1541414 a slow sisk drive and the Commocore 15717 a new high soeed disk 
drive that normatly is sola with the €128. The 319885 module determines 
which tyoe cf agrive that 1s connected and calls the anoropriate KERNAL 
poutines. All data transfers done Sy the SIOS¢S are dane toc a 256 byte 
suffer. The 239 ais then fresoonsidle for moving data to the proper 
memory location (bank and ardress). 
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10.6e1.1 S3OOTING OF CP/M PLUS = 


The autoboot method used with the €128 is to read the first sector 
on the disks check that it is a boot sector (first three bytes are CB”). 
If it is a boot sector jit is loaded into memory at $1009 and executed. 
The CP/“% boot sector will meet the above requirements and in turn load 
the 65090 3I10S. Control its then given to the 8500 3I0S. The 86500 21205 
sets up the 2780 memory map and transfers control to the Z380 Cat location 
JO000 bank J). The CP/4 ROM gets control and loads the CP/M system from 
disk Cusing 85930 31395 to do disk funetions). <After CP/M is loaded, 
control is transferred to CP/M cold voot. The cold boot routine then 
reads CCP.COM to 10CH in bank 1.2 A copy of the CCP.CO4 file is then 
transferred to oanked memory so that warm boots do not have to load 
Cc>.COM from disks odut instead transfers the CCP from oanked menory. 
dith the CC® in the TPA program control is transferred to it at location 
100H in bank 1. 


The structure of the boot sector is defined and is presented vnelow. 
The boot sector has the following format. 


1/ read disk block at track 1 sector 0 into ram at $0000 (*tbuffr'). 
24 check for auto-d00t signature. RTS if not. the relative format is: 


$90 $01 $02 $303 $934 $05 $06 swrrerrers= A eewrerorrer= 30 233 -=> SFF 
1 | | | | { } Coptional) | Coptionatl) | 
C R M adrl adrh bank Sbolk diskname 0 filename 9 6502 code 


3/ TF #bolk > O THEN block _read sequential sectors into ram at 
given adrls adrhs sank Location. 

4/ YF filename THEN Load filename into ram bankO Cnormal load). 

5/7 JSR to user code following filename (system map). 
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10e6e1.2.2 READ A SECTOP OF DATA FROM SISK CFAST AND SLOW) =- 


Prior to calling this routine CP/™ sets the tracks sectors, OMA 
addresss O*A sank and the number of sectors. CPs sets the track and 
sector using tne data in the PA. This means that for the new disk 
format the sector is always zero and the track is the block number 
relative to the start of the disk. The Z20 5108S translates this to the 
proper track and sector numoer for the disk drive (sector translation 
also). If the disk is the older tyne (C54 CP/M) then the track and 
sector numoders set by CP/M do not need to de converted. If the disk 
drive is the new hich soeed drives then the 2160880 determines the number 
af consecutive sectors on the same track. The 210835 routine is called 
to set uo the multiole sector transfer. Control is then returned to 
3Y0S$80 ana the 2290 then reads the cisk data from the I/) cuffer 
Girectlys and writes it to system nemory Cat the OMA address). If the 
disk drive is the clder and slower 15414 then the 210385 reads one 
sector at atime to a 255 byte sector ouffer and the 810820 moves the 
data to the correct Location in wxnemory (O¥*A address). The 310835 
routines are responsible for doing retries and reporting hard errors and 
relogging of tne disk to the 7Z3C.. 


10660165 WRITE A SECTOR CF DATA TO DISK CFAST AND SLOW) - 


Prior to calling this routine CP/M sets the tracks sectors OMA 
addresss O”A dank and sector count. CP/% sats the track and sector 
using the data in the 0Ps. This means that for the new disk format the 
sector 1S always zero and the track is the block number relative to the 
start of the diske The 2289 2IOS translates this to the proper track and 
sector number for the aisk drive (sector translation also).If the disk 
drive is the new high soeed trives, then the 516820 counts the number of 
consecutive sectors on the same tracx and ovdasses this info to the 
BIOS8S.e. The EIOS85 routine then sets up the transfer of multiple 
sectors and returns to the 21T90S80. The 2L0S8Q9 then reads the data from 
the current OMA address and writes this data directly to the I/0 oort. 
If the disk is the older types then 310830 writes one sector at a time 
by moving the OMA ouffer contents to the 256 byte disk read/write 
suffer. The 3190535 is then called and the buffer is written to disk.The 
8500 B8I0S also checks whether a cisk has teen chanced and returns the 
appropriate error code if it hase 


10e6ete 4 READ A SECTOR OF DATA FFOM RAM DISK @- 
Capies 123 bytes of data from the RAM disk addressed by the track 


and sector to the current OMA dank and address. This function is 
performed totally by the 739. 
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102680125 WRITS A SECTOR OF DATA TO QAM OISK — 


Canpies 12€& bytes of data from the current DMA address and dank to 
the RAM disk addressed by the track and sector. This function is 
performed totally by the 730. 


1Oe60e1e.5 COPY COP TO HIDDEN PA% FROM TOA 1DSH = 


This function is performed cnly when the systen is first booted. 
The CCP.COM file is loaded from disk into the TPA. Normally the CCP.CO*™ 
file would be read from sisk each time the systen iS warm started (going 
back to the 4> promot). The reloading af the CCP is done so often, 
which slows cown the system (by coirg a Lot of disk accessing)s that it 
makes it worth keesing a cooy of the CCP in Danked memory. This routine’ 
is responsible for saving a copy of the CCP.COM file the first time it 
is loaded. This cory of the CCP is then cooied to 100H in Dank 1 Cthe 
TPA area) when the system is warm started. This function is performed 
totally oy the 755. 


TDe6aele? COPY CCP TO TPA 100H FROM HIDDEN RAM = 


This function is called when the system onerforms a warm Doot. See 
section 1025.1-5 for more cetails on hew and why the function is used. 
The CCP is copiea from its 2A* Suffer to 130H in Fank 1.2 This function 
¥s oerformed totally by the Z3c. 


1Ge6e1te2 FORMAT OISK = 


This function reformats the disk. The fill character is normally 
eS*s for CP/M systems cscut this is only required for the directory 
sectors (first track). This function should only de used with a format 
program that can create a system disk. The format program is able to 
create two different disk formats. The first oeing the ald C454 CP/™ 
format. There 3s an option of copying the C54 system tracks from 
another disk or just Leave the system tracks blank ( the directory track 
(18) is also set up). The second format is tne new C7128 CP/M disk 
format. This version creates the boot sectors on the new disks formats 
the directory area anc sives the user the option of cooying the CPM.SYS 
and/or the CCP.CO% files to the newly formatted disk. 


10.622 CHARACTER TRANSFER OPERATIONS 

The character transfer aperations are handled mostly by the 3500. 
One major exception to this is the 60/80 column display system which is 
handled by the 750. 
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1060201 KEYROARD SCANNING - 


The keyDSoard scan routine that is called to get a keyboard 
character returns the key code of the oressed key of FFhH if no key is 
currently oeing oressed. The keyboard scan code is also responsidle for 
handling programmable k@yS~p programmable function keyss setting 
character and background colors, selecting MFM disk formats, and 
selectins current screen emulation tyose. 


Any key on the keyboard can oe defined to generate a code or 

function except the followina keys: 

Left Shift (Cand Lock key) 

Right Shift 

Commotore “ey 

Control Key 

Restore C3502 NST) 

80740 Disclay Cused to select key) 

Caps Lock Key 


The keydoard recognizes the following special functions: 
Cursor Left key - define key 

Cursor right key = define string (points to function keys) 
ALT Key - taajle key filter 


Define key: 


This function allows the user to define the code that a key can 
produce. Each key has four aefinitionss Normals, aloha shifts shifts and 
control. The aloha shift is tojagled onsoff by oaressing the Commodore 
K eye After entering this mode a small whit? box witl appear on the 
Dattom of the screen. The first key that is oressed is the key to de 
defined. The current HEX value defined ta this key ts displayed and the 
user can then tyoge the new hex code for the key or abort oy typing a 
nonmhex key. The following is a definition of the codes that can be 
assigned to a key. (In ALT modes, codes are returned to the application. 
See ALT. mode) 


00h Null (sane as not pressing a key) 
O1h-7Fh normal ASCII codes 
8Oh~SFh string assijned 
AQKwAFh 50 column character color 
BIRKS FH 40 column sackgroungd color 
COhR“CFh 40 column character color 
DUNT OFA 40 colomn vnackgjround color 
EQH@EFh 40 column oorder color 
FOR“FFh special functions 
FOR toggle enanlesdisable disk status indicator 
Fih XON/XOFF display Coause) 
F2h Cundefined) 
F Sh 40 column screen window right 
F4h 40 column screen window Left 
FS undefined 
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Define strings: 


This function allows the user to assign more than one key code to a 
single key. Any key that is typed in this mode is placed in the string. 
The user can see the results of typing in a long box at the bottom of 
the screen. NOTES some keys may not display what they are. To allow 
the user control of entering datas five special functions are availadle. 
They are all control rignt shift functions (this allows the user to 
enter any key into the buffer). 


EDIT string functions: (CTRL RT. SHIFT) 


RETURN - done defining a string 
main ‘%+?* - insert a soace into string 
main ‘=* - delete cursor character 
lf arrows - cursor Left 
rt arrow - cursor right 

ALT mode: 


This function is a toggle Caon/off)? and is provided toa allow the 
user to send 3 pit ¢eodes to an anplication without the keyooard driver 
eating the code from 8uGh to FFh. 


10260202 USDATE 40/80 COLUMN DISPLAY - 


There are two totally different display systems within the C€-123. 
The first is tne VIC chip that produces a _¢5 Line by 40) coluan displey 
ang has many araphics modes af operation and can be used with a stanaard 
Color TV or calor monitor. The only mode of overation that is being 
used by CP/™% Ys normal character mode with each character and screen 
background having up to 10 colors. The second display system will only 
work with a monitor (black and white or color), called the 85634 and is 
structured after the 6545 disslay controller. The display format of 
this controller is 24 Lines by 80 columns with character color 
attributes. The VIC chio is a memory mapped disolay and the 6845E is 
1/0 controlled. The two display sudsystems are being treated as two 
totally separate disolays. CP/M Plus can assign them dSoth or only one 
to the console output device. oth disolays are controlled Sy a common 
terminal emulation package (Corobably a AOM~3A driver). The display 
subsystems are controlled totally by the 280 S8I0S. The emulations 
software is written in such a way so that different terminal emulators 
can be substituted for the AOM=3A emulation poy the user. 


The terminal driver is divided into two different parts: terminal 
emulation and terminal functions. A number of different emulations may 
be providea. A few af the options are the ADM=3A, ADM—@317 %$HI9e VTS2e 
and V1T100. The terminal emulation is part of the 230 SI0S and the 
terminal function part is primarily in the Z80 ROM, 
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1Debe2e3 TERMINAL EMULATION PROTOCOLS - 


T0e5e2050e1 LEAR STEGLER ADN=3A — 


LEAR STEGLER AOM~3A 


Character Sequence HEX Char Code 
Position cursor <ESCro=zaCrow 432) Ccolk #432) 13 30 20+ 20+ 
Cursor Left AY 33 
Cursor Right a Q¢ 
Cursor Down a) OA 
Cursor YU» “x 03 
Home % Clear Screen AL 1A 
Carriage Return AM Od 
Escape a 12 
Rell AS 07 


NOTE: display is 24 (1-24) dy SU (1-8C), cursor origin is always 1/1 
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1026022322 


e 


NOTE: 


LEAR SITEGLER ADM=-31 = 


LEAR STEGLER ADM— 31 


Clear to na af Line 
Clear to Eng of Seren 


Home 5» Clear Screen 
Half Intensity On 
Half Intensity Off 
Reverse Video On 
3linking On 
Underline On 

Select Alt Char Set 
Reve. Video 2 slinkings Irf 
Insert Line 

Insert Character 
Oelete Line 

Delete Character 
Set screen colors 


This 318 not a norasaal 


Note: Gisolay is 


cursor sFicin 


Characater Sequence 


<= SCOT 

<ESC>L 

<ZECDY 

<ESC>y 

<ESC>: 

<=2=3C>~* 

<eSC>) 

<=ESC>HC 

€ESCHGS 

€ESC G2 
<ESEC>HGS 
<ES CG 1 
<£SC>GC 

KESCOE 

€E8C>2 

<eESC>R 

€ESCod 

<€ESC ESC ESC> color # 


ahere color # = 29h to 2Fh 
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HEX Char Codes 
13 54 


13° 74 
13 59 


- character color 


30h ts SFA - backgrd color 
: 40h to 4Fh = border color 


Ad431 seanuence. 


0&4 (1724) by 386 (1239), 
is akways 17/1 


(40 col only) 
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TOQebe le 3e 3 VT52 = 


Cursor us 

Cursor Oouwn 

Cursor Right 

Cursor Left 

Enter Graphics Mode 
Exit Srachics Mode 
Cursor Home 

Reverse Line Feed 
Erase to End of Screen 
Erase to End of Line 
Cursor Addressina 
Identify 

Enter Alte Kaynpad “ode 
Exit Alt. Keypad Mode 
Enter VT10C “ode 


NOTE: display is 24 (1724) 


<cSCDA 
<ESC>5 
<ESCOC 
<eSC>o0 
<cSCoF 
CESCD 4 
<cSC>H 
<ESCOI 
<ESC>J 
<ESCHK 


CESCOY Crow Fh) Ccol 441 Fh) 


<ESC>2 
<ESC>= 
<ESC>> 
<ESC>< 


VT52 


- (3 - 
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by 20 (1789), cursor origin is always 1/1 
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10.4520 32% VT109 = 


VT100 


A sudset of the ANST X3.5471979 and X344171974 standards 


Video Attridutes KESC>CCPs ds wees (PSI M 


where (Ps) iss 
) Noemal Call att. off) 
1 Tald 
4 Y‘inderscore 
5 Link 
7 Peverse 
Character Sets $0 Set G1 Set 
JK <ZSC>CA <ESCDIA 
ASCII <ESC>(3 <ESC>)3 
Soecial Graphics <ESC>(O <ESC>)0 
Alt. OM <ESC>¢1 <ESC>) 1 
Alt. 90" Special Graohics <eSC>(2 <ESC>)2 
Character Size 
Dauble High Top aAalf <ESC>A?Z 
Dounle High dottom Half <25C>K4 
Single width Single Height <ESC>85 
Double widtn Single Heicht <cSC>#é 


Cursor “avements 
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Position Cursor <ESCOC Crows cec ds Ccol#dec)yH 13 xx 30% xx 39¢ «& 
<eSC>CCrowfdecd) (cal sdec) f 13 xx 304% xx 30+ 4 

Cursor Left <ESCO>CLCH)D 139 xx 30+ 46 

Cursor Rignt <ESECD>C CHIC 13 xx 30% 43 

Cursar Sawn C<ESCOLCR)2 18 xx 30+ 42 

Cursor Up <ZESCOCCHIA 138 xx 30% 4&1 

Index <€ESC>O 19 44 

New Line <ESCDE 13 45 

Reverse [Index <ESC>™ 13 40 

Save Cursor @ Attrib. <=SC>7 

Restore Cursor £ Att. <fSC>3 

crase 

Clear to End of Line <=ESCOCK 18 xx xx 

Clear to End of Screen <€ESCOLCJ 13 xx xx 

Clear from Start of Line <ESCOLIK 18 xx 31 xx 

Clear from Start of Sern <escecolty 15 xx 31 xx 

Clear cursor Line <ESC>C 2K 139 xx 32 xx 

Clear entire Screen <ESCOCL 13 xx 32 xx 
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LED®s CESCOC CPs ds eees (S5)Q 
QJ Extinguish all 
1 Li oon 
2 L2 on 
3 3 on 
46 4 on 
Media Copy KESCOLC CP sdh 
Modes 
Enaole <ESCOCCPsd)h 
Disable KESCOC CPsdl 
where (Ps) iss: 
Pace) New Line Line Feea 
74 Aoplication Cursor (cursor key mode) 
92 nla VTS2 mode 
73 132 Colunn 29 column 
74 Smooth Scrolling Jumo Scrolling 
75 Screen Rev Video Sereen Normal Video 
7% Screen Jrigin 
Relative Sereen Origin Absolute 
77 Line wrao On Line Wrao Off 
a2 Auto *2peat On Auto Reneat Off 
> Interlace on Interlace Off 
Keyoad Apnolications “ode <ESCD= 
Keypad Numeric “Mode <ESC>> 
Peports 
Cursor Pasition 
~invoked by <FsctoCsn 
“response <ESCOC CPL Is CP DR 
Status Resort 
“invoked by <ESCOCS 
“response <ESC>CIOnN Cterminal OK) 


<ESC>L3In Cterminal not OK) 


Terminal Parameters 
“invoked by <ESCo> 
“response <ESCD> 


what are you 
-~invoked by <ESC>CeE or € <ESE>Z ) 
“response <ESCOCIIE (CPs de 
where (Ps) is 


QO 3ase VT109% no options 

4 

2 

3 

6 

5 

6 

7 
Reset to Initial State <ESCPe¢ 
Scrolling Resion <ESC>C CPt). CPb)r 

adhere (Pt) is too Line # 


(Pb) is bottom line 3 


Tabs 

Set tas <ESCDH 

Clear tao S250>%5 

Clear all tabs <ESC>33 
Test 

FILL screen with Es <OSC>#2 
Null 00 
Sell AG 07 
HT ay 09 
LF a OA 
VT Csame as LF) AK 08 
FE (same as LF) et Oc 
CR aM 00 
SO (select G1 char set) AN JE 
SI (select 3° char set) AQ OF 
CAN (terminate escape seq) “x 
$US Csame as CAN) er 


Notes Display is 2€4¢€1724) by 80(1790) or 26 by 132, 
cursor ortain can de set from 1/1 to 24/1. 
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10 .60e20%4 PRINTER INTERFACE ON SERZTAL 3U5 @- 


The Commodore printers are very cost effective but connect to tne 
serial bus anc are not very faste For this reason two different printer 
drivers are installed in the systen. The RS232C driver allows the 
connection of any RS232C printer but at a much higher cost and the loss 
of the R3232 port for other operations. The driver for this interface 
is descridned in section 16454226 This section deals with the serial bus 
printers. Alt of these orinters work with PET ASCII (two sets of 
arintapla characters, uoper case with grapnicss and an uoper and lower 
case with upper and Lower case swapoed) and a few also work with normal 
ASCII. Thus tne reat ASCII characters from CO/M must de convertedto PET 
ASCII im most cases before it is sent to the orinter. To further 
complicat2? things some of the printers only have upper ¢c3se so a force 
to upper case may also be necessary. The 220 SI0S handles all of the 
canversion and gives the character ta the 3500 to send to the printer. 
The 2592 is set uo to time out if the orinter is missing or out of 
service so that the systen does not hang. 


The following orinters are susoorted: 


MpPs-251 Oot Matrix Printer So cos) 
mPS=802 bot “atrix Printer (50 cos) 
MPS~203 Jot “atrix Printer €40 cos) 
DPS-1101 Daisy wheel Printer Csupports normal ASCII) 


VQebe205 GET A CHARACTER FRO 2$232C ADAPTER (wITH XON/XOFF) - 


The 8$232C port does not hAave a USART to do the dirty work for it. 
This means tnrat the serialization of the data must de done by the 
microorocessor.e. The 8530 micropracessor KERNAL contains routines that 
receive the bits and builds the characters. For these routines to work 
the 2500 processor must de running. To get around this oroblem XON/XOF F 
Logic is used. When the 239 wants a character it asks the 85006 to get 
ite The 9500 then sends an XCN character. After the first character is 
received an xXOFF is sente The 3500 waits for a full character time 
after the XOFF is sent or until the next received character is received 
before the Z5C 1s turned back one. Any Characters that came in after the 
first are Suffered and the next tine the 730 wants a characters if one 
is itn the buffer, it is returned to the Z80 without turning on the 
channel again (with an XON). 
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1060205 SEND A ChARACTER TO RS232C ADAPTER - 


The 33232C port outout is simoler than the inout (see 10.5.2.5). 
The 230 yjives the character to oe sent to the 8599 and the 5500 retains 
control until the character is totally sent Cincludina the stoo bits). 
Then the Z3cC is given dack control. One special case that is handled is 
that before the first character is sents an XOFF is sent so that thre 
device that is being communicated with knows that it cannot talk. Also, 
the device beings communicates with may senna an XON of XOFF. Since we 
may not 32 in there when it comes ins we aust stay in the Send Char 
routine long enougn to receive 3 control character. Some devices” may 
never senj an XIX/XOFF ana then thre added delay may not be necessary. 
Thuss this aadec delay 1s nenu selectable. The effect of the added 
XKON/XOFF delay is to divice tne effective AUD rate by annroximately 2. 
(1200 3AUD would have an effective rate af approximately 699 2AUD). 


The 2A4UD rate can de set from 112 to 1230 =3AUD. This functian 


changes the ?AU9D -eate to the value supplied and sends an XOFF char to 
the connected sevice (see 10.5.2.5) 


10.5.5 SYSTE*™ OPERATIONS 
10.6361 SET SYSTEM TI“e = 


The time of day is set with this function. The time of day is 
stored in packed 2CD format in tne System Control Slock (SC3) in three 
Locations Chourssminutessseconds). This routine reads the SC8 time and 
writes that time to the time cf day clock within the 6526. This tine is 
uodated on the chip and is useqa sy CP/M. The 28) is able to set and 
read tne 6525 directly. 


TQe6e5e2 UPDATS SYSTE4 TINE 


The SCG time is updated from the time of day clock on the 4526. 
This function is done oy the 259. 
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This routine ts tne key to using the extra 2AM banks. This routine 
is passed the source address and bank number, the destination address 
and oank number and the number of bytes to transfer. The transfer is 
done using the two “MU dajge pointers and the 2890*%s block move. There 
are three basic cases that are haniled. The first is 2545=-byte moves 
that are space aliqnedade The second is a dage aligned move of less than 
256 pytes. The third cas? is where the 3 LS32's are not equals and the 
effective aadresses must be comoutedad twice for each 255 dyte block 
moved. The third case Should not occur normallys but it should 09>e 
tested for and handled in the event that it does occure The majority of 
the moves are of the first tyce and this routine is optinizea for soeed. 
The secona and third cases occur less freauently and do not need to de 
as fast. This code MUST reside in tne common nemory area and bank C 
Cannot oe enabled when it's invoked. The reason for this is that the 
Z830 ROM will overlay pate 0 and 1 when bank 9 is selected. 
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10.7 3500 3110S ORGANIZATION 


The 3500 is responsible for most of the Low Level Yr/0 functions. 
The request for these funetions is made tnrough a set of mailboxes. 
Once the mailboxes 3re set up the 270 shuts down and the 3509 starts up 
C3I0S85). The &859C Looks at the command in the mailbox and performs the 
required tasks sets the command status and shuts down. The 230 is 
reenatled and tlooks at the commana status and takes the aporooriate 
actions. 


The structure of the mailodoxes ts as follows: 


Command 1 byte 
Status 1 oyte 
Orive 1 byte 
Track 1 byte 
Sector 1 byte 


The Commands are 3: 


Resets, return control to the 28500 (CSaSIC) 
Disk read 

Disk write 

Format the disk 

Get a key 

Send a byte to 288232C 

Read a byte from RS$232C 


SEE BELOW 
The status format is as follows ; 
4S3 Loe 
X7 X6 XS X& X3 X2 XT Xd 
No errors if all bits are off 
If x7 is on then an error has occured and the error type can be feund 


by Looking at the rest of the bits. The neaning of the rest of the 
bits is dependent on the command. 


- 29 <= 
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COMMAND § 


90 Resets return control to 33500 CSASIC) 
Input: None 
Outouts: None 


Functions Returns control to the ?75C) 3aSICe The CP/M environment 
is lost» and the system nust be rebooted to rerenagole 


CP/M, 
01 Disk read (slow) 
Tnouts: Tracks sactofs, and drive numoer 
Output: Command status 


Function: Read a sector of data trom disk to the sector ouffer. 


U2 Disk write (slow) 
Input: Track, sectors and drive number 
Sutput;: Conmand status 


Functions: write a sector af data from the sector buffer to disk. 


03 Disk read setuo (fast) 
Inout: Tracks, sectors and drive number 
Jutput: Command status 


Function: Used to setuo a read of the specified number of sectors 
from disk. 
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04 Disk write setup (fast) 
Inout: Tracks sectofs and drive number 
Sutsuts Command status 


Functions Used to setup a write of the specified numoer of sectors 


to cisk. 

05 Format a new cisk 
Inout: Drive numoer 
Outputs Command status 
Functions 

eK.) send character to the orinter 
Inout: Character toa send 
Jutputs: Command status 


Function: S@nc a character to the orinter on the serial bus. 


CP/™ MODE 


Page 16-31 


190-8 CP/*® B3IDS ORGANIZATION (810839) 


0 e00T 
3anks 
Inputs: 
Jutouts: 
Functions 


1 W300T 
Jank: 
Input: 
Output: 
Functions: 


2 CONST 
Bank: 
Input: 
Outouts 


Function: 


3 CONIN 
Sanks 
Input: 
Yutouts 
Functions 


a) 

None 

None 

This code does all of the hardware initializations 
sets uo zero oajges prints any sign7on message and 
Loads the CCP and then transfers control to the CCP. 


oor 

None 

None 

This code sets up page zeros reloads the CCP and 
then executes the CCP. Crelocate the stack to common 
memory to make 30CS calls). 


QO or 1 

None 

A=JFFH if console character 

A=QCH tf no console character 

Checks the console input status of the current 
console device. If any of the devices have a 
character availables FFH is returneds else QOH 
is returned. 


Oor 1 

None 

A=ASCII console character 

Reads a character from any ONE of the assignea 
console inout devices. A scan of each assigned 
device is done until an input character is found. 
The cnaracter is returned in the A register. 


CP/™% MODE 


4 CONOUT 
dank: 
Input: 
Jutouts 
Functions: 


5 LIST 
Sank: 
Input: 
Output: 
Functions 


6 AUXOUT 
3ank: 
Inputs 
Output: 
Functions 


? AUXIN 
Ranks: 
Inouts 
Output: 
Functions: 
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O or 1 

C=ASCII character to aisplay 

None 

Sena the character in C to ALL devices that are 
currently assiqned to the console. wait for all 
slower devices. 


0 or 1 

C=ASCII character to arint 

None 

Send the character in C t9 ALL devices that are 
currently assianed to the LIST device. wait for 
all slower devices. 


0 or 1 

C=ASCII Character to send to AUX device 

None 

Send the character in C to ALL devices that are 
currently assianed to the AUXOUT device. wait for 
ALL slower devices. 


QO or 1 

None 

ASASCIY character from AUX device 

Reads a character from any ONE of the assigned 
AUXIN devices. A scan of each assigned device 15s 
done until an input character is found. The 
character is returned in the A registere 


] 
t €Y) 
& 

A 
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3 HOME 
Banks: 0 
Inout: None 
Outputs None 
Functions Homes the head on the currently selected disk 
drive. This function sets the current track to J 
and does not move the head of the disk in this 
product. : 
9 SELOSX 
Sank: 0 
Inputs C=Disk Orive (0-15) (A=0) 
EzInitial Select Flag 
Outout: HL=Address of disk parameter Header (CDPH) if 


drive exists. 
HL=000H if drive does not existe 

Functions Selects the disk drive whose address is in C as the 
current drive for all further disk operations. [f 
the LSA of the — register is a Zeros then this is the 
first time Logging of this disk. The disk tyne (C54 
CP/M or €123 CP/™) should be checked and the DPB 
parameters adjusted for the diskette currently in the 


drive. 
10 SETTRK 
Banks 0 
Inout: 3C=Track number (0-34) 
Output: None 
Functions Register pair 8C contains the track number to be used 


in the subsequent disk access. This value is saved. 


11 SETSEC 


Sank: 0 

Taputs acC=Sector nunder 

Outputs None 

Function: Register pair BC contains the sector number to be used 


jin the subsequent disk accesse This value is saved. The 
value in 8C is the value returned by the sector trans- 
Lation routine. 
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12 


13 


14 


SETDSA 
Banks 
Inputs 
Qutput: 
Functions 


READ 
Banks 
Tnoputs: 
Output: 


Functions 


WRITE 
3anks 
Inputs 
Outputs: 


Functions 
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0 

BC=Direct memory access address 

None 

The value in 8C is saved as the current OMA address. 
This is the address where ALL disk read or writes occur 
to or from. The DMA address that is set is used until 
it is changed by a future call to this routine to 
change it. 


0 

None 

A=Q000H if no errors 

A=001H if nonrecoverable error 

A=OFFH if sedia has changed 

Reads the sector addressed by the current disks track 
and sector to the current DMA address. If the data is 
read with no errors then A=0 on return. If an error 
occurss the operation is tried several more timess 
and if a good read does not occur then A is set to 
OOTH. A test for media change should de done each 
time this routine is called and A is set to ~-1 if 

the media has been changed. 


8) 

C=Deblocking code (not used) 

A=Q00H if no errors 

A=001H if nonrecoverable error 

A=002H if disk is read only 

=OFFH if media has changed 

Writes the sector addressed by the current disks track 
and sector from the current DMA address. If the data 

is written with no errors, then A is set to 0 on return. 
If an error occurss the operation is tried several more 
timess and if a good write does not occurs then A is 
set to OO1H. A test for media change should be done 
each time thts routine is called and A is set to ~1 

if the media has been changed. Alsov if an attempt 

1s made to write to a read-only disks then the A 
register is set to O0O2H. 
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15 


16 


17 


13 


LISTST 
Sank: 
Trout s 
Outputs 


Functions 


SECTRN 
Z3ank: 
Input: 


Sutput: 
Function: 


CONOST 
Ranke: 
Tnputs 
Outputs 


Functions: 


AUXIST 
Banks 
Tnputs 
Output: 


Functions 
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9 or 1 

None 

A=O00H if List device is not ready to accept a charact2re 
A=OFFH if List device is ready to accept a character. 
This routine scans the currently assigned list devices 
and returns with A set to OFFH if ALL assigned devices 
are ready to acceot a character. If any assigned device 
is not ready then A is set to OOH. 


0 

8C=Logical sector numder (0-n) 

DE=Translation taodle address (from 0P3) 

HL=Physical sector number 

This routine converts the ohysical sector numoer to a 
Logical sector number. If no translation is needed then 
move the 8C register to HL and return. 


Cor 1 

None 

A=QFFH 1f Ready 

A=O000H if not Ready 

This routines scans the currently assigned console 
devices and returns with A set to OFFH if ALL assigned 
devices are ready to accept a character. If any assigned 
device is not ready then A is set to OOOH. 


QO or 1 

None 

A=OFFH ¥f console character present 

A=Q00H if no console characeter 

Checks the status of the current AUXIN device. If any 
of the devices have a character available, OFFH is 
returneds else OOOH is returned... 
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19 AUXOST 


Bank: OQ or 1 
Inout s None 
Output: A=OQFFH if ready 


Functions 


A=QOOH if not ready 

This routine scans the currently assigned AUXOUT 
Gevices and returns with A set to OFFH if ALL devices 
are ready to accept a character. If any assigned device 
is not ready then A is set to OOK. 


DEVTSL 
Ranks: Oor 1 
Inputs None 
Outouts: HL=address of character I/0 table 


Functions: 


This routine returns the address of the Character [/0 
table. This table is used to name each of the driver 
modules and set/control the baud rate and XON/XOFF 
Logic for each driver. Note: the device drive mech= 
anism is used to replace the IO3YTE used with CP/4% 2.2. 


DEVINI 
Banks 0 or 1 
Inputs C=device number 
Outputs None 


Functions 


Used to initialize the physical character device 
specified in the C register to the SAUD rate tn the 
OEVTBL. 


ORVTBL 
3Jank: Q 
Input: None 
Output: HL=address of the drive table 


Functions: 


Returns the address of the drive table in HL CNOTE: 
first instruction "UST ce LXI HsDRVT3L). The drive 
table is a list of 16 word pointers that point to 
the DPH for that drive. [f a drive is not poresent 
in the systems then the pointer for that drive is 
set to zero. 
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23 MULTIO 

3anks: 8) 

Inout: C=multisector count 

Outputs: None 

Functions The Multisector count is set before the tracks sector, 
and OMA address and the reads/writes of the sectors 
occur. A maximum of 16K can be transferred by each 
multisector count. The 15417 has 256 byte sectors, 
thus the smaximum count is 64. When sector skewing is 
dones a List should be created that contains the ohys- 
jcal tracks sectors and DMA address of each read/write 
sector and after the Last sector is entered into the 
Liste The List should be sortedby track and sector. 
The read/write oneration should then be performed. 
Multisector transfer is ONLY worth while with the new 
faster disk drive. 

24 FLUSH 

Sank: 8) 

Inputs None 

Output: A=0C9H if no errors 


=901H if nonrecoverable error 
A=Q02H if disk is read-only 
A=OFFH Tf media has changed 

Functions This routine is used only if blocking/deblocking is 
done in the SIOS Cit is not). This code ALWAYS returns 
with A =00H. 


25 POVE 
Banks 0 or 1 
Tnout: HL=destination address 
DE=source address 
SC=count 
Outputs HL=HLCIind*+9CC ind 
DE=DECI nd +8CCind 
Functions Move a block of data. Data to be moved is to/from the 
current memory bank Cor common) unless the XMOVE 
routine is called firsts, then the move is an interbank 
data movement. 
26 TIME 
Sank: Q or 1 
Input: C=000H (Time Get) / OFFH (Set Time) 
Output: None 
Function: This function is called with C=00H if the system time 


in the SCB needs to be updated by the clock. If C=OFFH, 
then the tise in the SC8 has just been updated and the 
clock should be set to the SCB time. NOTE: HL and DE 
MUST be preserved. 
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27 SELMEM 
Banks 
Input: 
Outputs 
Function: 


28 SET3NK 
Banks 
Input: 
Outputs 
Functions 


29 XMOVE 
Bank: 
Tnoput: 


Output: 
Functions 


30 USERF 
Banks 
Input: 
Outputs 
Functions: 


31 RESERV 
Ranks 
Inputs: 
Output: 
Functions: 


32 RESERV 
Pank: 
Taputs 
Output: 
Functions 
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9 or 1 

A=memory bank 

None 

Used to change the current memory bank. This code “UST 
be in common memory. NOTES ONLY A can be changed. 


0 

A=OMA memory dank 

None 

Set the DMA bank for the next READ/WRITE operation. 


0 

S=destination bank 

C=source bank 

None 

Provides the system with the ability to do memory to 
memory OMA through the entire system space. This func= 
tion does not have to be supplied. If this function 

is missings the first instruction MUST be a RET. 


N/A 
N/A 
N/A 
NZA 


N/A 
N/A 
N/A 
N/A 


N/A 
N/A 
N/A 
N/A 
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10<8.1 DATA STRUCTURES 
System Control slock - SC5 


The System Control Slock is a 100 byte data structure. The data 
structure tis used as the basic communication between the various modules 
that make up the CP/M Plus system The contents of the data structure 
are system parameters and variables. 


DRVTSBL Drive Table 


DPHO through DPH15S 


A list of 15 word pointers Creverse byte format). The first 
pointer (D5PHO) is drive A and the Last pointer (DPH1S) is drive P. The 
pointers point to the XDPH for that disk drive. Any drive that is not 
in the system has its pointers set to zero. 


XOPH Extended Disk Parameter Header (Normal DPH with a header) 


WRT READ LOGIN INIT TYPE UNIT XLT -O- MF DPS CSV ALV DIRSC3 DTASCB HASH HSANK 
16b 165 165 166 5b 80 165 72b 3b 16b 160 16b 160 165 166 Bo 


10. <3 -6 eh, oc -1 O #2 411 #12 +14 416 +18 #20 #22 +24 


eRT Contains the address of the sector write routine for this drive. 
READ Contains the address of the sector read routine for this drive. 
LOGIN Contains the address of the login routine for this drive. 
INIT Contains the address of the first time initialization routine 
for this drive. 
TYPE This byte is used dy the 3IOS to keep track of density and media type. 
UNIT Contains the drive numoer relative to the disk controller. 
XLT Contains the address of the sector translation tadle or zero if none. 
= o> 300S scratch areae (9 bytes). 


MF Media flag set to zero if disk lagged ine 3I0S sets to OFFH If media 
has changed. 
D PS Contains a ovointer to the current O0PB that describes the current 


media type. 
CSV Contains a pointer to directory checksum area (Cone per disk drive). 
ALV Contains a pointer to allocation vector area (one per disk drive). 
DIRBCB Contains a pointer to a single directory Buffer Control 3lock (8C3). 
DTSB8CB Contains a pointer to a single data Suffer Control S3lock (8C8). 
HASH Contains a pointer to an optional directory hashing table CFFFFH is not 
used). 
HBANK Contains a bank number of the directory hashing table. 
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Disk Parameter Stock - DPB 


SPT BSH BLM EXM DSM DRM ALO AL1 CKS OFF PSH PHM 
16d 8d 8b 8b 16d 166 8b 3b 16d 16b &b 8b 


SPT Number of 128 records per track 

3SH Data allocation block shift factor 

BSL Block mask 

EX Extent mask 

OSM Number of ailocation block on disk ainus one. 

DRM Number of directory entries minus one. 

ALO First bytes directory block allocation vector. Filled from MS8 to LSB 
AL 1 Secand dSytes Cuno to 16 allocation blocks can be used for the directory. 
CKS Size of the directory check vectors, (DRM+1)/4. 

OFF Number or reserved tracks at the beginning of the disk. 

PSH Physical record shift factor. 

PHM Physical record mask. 


Buffer Control Black (LRU Control Alock) - 3C3 


DRV REC# WFLG OO TRACK SECTOR JUFFAD BANK LINK 
8 24b 8b 8b 166 166 166 86 166 


ORV Drive associated with this record. Set to OFFH when not used. 
REC# Contains the absolute sector number of the ouffer. 
WFLG Set to OFFH when puffer contains data that must be written to disk 
JO Scratch byte used by 3008 
TRACK Physical track address of buffer 
SECTOR Physical sector address of buffer. 
BUFFAD Address of the buffer associated with this 83C8. 
BANK Bank number of ouffer associated with this 3CB. 
LINK Contains the address of the next 8C3 in this linked list. 
Set to zero if laste 
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CHAPTER 11 


FAST DISK INTERFACE 


11.1 SERIAL BUS INTERFACE 


The F350 imolements a noacifjed 1541 serial interface. This bus is 
CompatidDle with the Commodore 34 Vic 20 and thre Plus & Series 
Comouters. In addition it its comoatiole with peripnerals such as 
printers, plotcrerss anc esoecially the 1541 disk drive. 


Fast Serial communication is transparent to the slower peripherals. 
There are three types of operations over a serial bus =~ Controls Talks 
and Listen. The host is tne controller and initiates all protocol an 
the sertal ous. The host reouests the peripheral to Listen or talk (Cif 
the peripheral is capasle of talking). All devices connected to the 
serial bus receive data transmitted over the Suse To allow the host to 
route its data to an intended destination, each device has a bus 
address. Device addresses are as follows: 


OEVICE ADDRESS 2-50 POSSTELE 


Ces - INTEPNAL DEVICES OS 
4-7 _ NORMAL CBM PRINTERS 
clad NORMAL CoM DISK UNITS 
12-30 UNUSED C8" DEVICES 


The bus consists of the following: 


Pin 1 =~ SRQ (Service Request) 


Unused by the current serial bus. Fast Serial will 
use this Line as a nirdirection fast clock line. 


Pin 2 = GND 


Chassis sround. 
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Pin 3 = ATTN Cin) 


Tne host brings this signal low which then generates 
an interrupt on the controller board. The attention 
sequence is followea oy an address. I[f the device does not 
respond within a oreset tine tne host will assume the 
deyice adoressea 1S not on the bus. 


2in 6 = CLK Cin/asut) 

This sijnal is used for timing the data sent on the 

serial ous (software clocked). 
Pin © =~ DATA Cin/out) 

Data on the serital asus is transmitted one ovsoit at a 
time Csoftware tossled). In addition this line is wsire 
®o5red' and used as a FAST DATA Line to cemoliment the FAST 
CLOCK on the 5°42 Line. 

Pin 6 = RESET 


This line will reset the gserijioheral uoon host reset. 
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147.2 FAST SEPTAL PROTOCOL 


The FSO drive oowers up in the slow serial mode. The host has to 
intt the drive to fast mode (The drive will remain in the fast mode 
until the command has terminated). There are no addition kernat calls 
required to interface to a FSD. Existing kernal routines are modified 
to allow slow and fast serial operation. within the kernal aie fast 
serial flag contains whether the current addressed oeripheral is a fast 
device. To initiate the FSD as a fast peripheral the host must send a 
HRF (CHost Request Fast) message. (see Fige 1) This is accomplished by 
sending eight clock pulses down the S?PQ9 (Service Reauest) Line. The 
6525 on the arive's controller dboara will sense the transitions and the 
6526 witl generate an interrupt. within the drive a flag is togsled to 
the fast mode. while in the fast node tne drive will send fast bytes to 
the hosts and when addressed as a Listener the drive witl send a ORF 
(Device Request Fast) message (see Ficse 1)- This message lets the hast 
know that the addressed peripheral can receive oytes fast (or slow). 
The fast serial flag within tha host can de cleared in the following 
ways: unlistens untalks serial bus errors and <run=stoo> <restore>. As 
mentioned oefore Dytes are clocked on the $2a Line with the data Line be 
toggled to the appropiate state. Cxisting routines used to accept bytes 
were modified to accept a fast byte as well as a slow byte. 
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11.3 SERIAL SUS COMMANDS = MODIFIED 


EXPLANATION OF TERMS: 


MRF = Host request fast 

drf - device request fast ( sourced by the drive ) 
LA ~- Listen address 

TA - Talk address 

SA * Secondary address 

SACQ) - Secondary acdress apen 
SACC) = Seconsary adjsaress close 
05 ~ Jata “yt? 

FN ~ File name oyte 

eat ~ Ens or identify hanash3ake 
TKATN = TalkwAtn handshake 


Command Aboreviation Jinary value 
2 host request fast HOF 1141 11911 
ke device reyguest fast OOF 0090 30909 
talk address (TA) 10m xxxx 
Listen address (LA) OCTx xxxx 
untalk CUNTLK) 0101 1111 
unlisten CUNLSN) 03911 1111 
secondary aadress ocen (SA(O)) 1111 yyyy 
seconaary aidress clase CSACC)) 1110 yyyy 
secondary address normal (SA) N4172 2222 
Fast ?yte messaces Cclacked over the Sr2 line) 


we Fast byte messaje sourced cy the drive 


Device Address (TA) (LA) = xe wuxxx values 9°30 possible 
Q=5 Internal devices 
4=7 Normal C&™% printers 
oes Normal disk units 
12-50 Unused 


Channel Address (SACG)) (SACC)) = yyyy values O-15 possible 


Disk Units 154X 


GC > PRG-TYP= Read Data Channel (special) 
4 =~ ORG-TYPE write Jata Channel (special) 
2714 = Channel for atl file types (read/write) 
15 - Unit command channel Cread/write) 


Normal Seconaary Address (54) = 2 zzzz values 0731 possible 
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11.4 STANDARD KERNAL CALLS 


Load: 


This routines loads data bytes from any inout device 
directly into the hosts memory. 


HPF LA SACO) drf FNT FN2weee FNI-1 COT FNN HRF UNLSN => 


HR8F TA S& TKATN 6091 032ee2e02N71 eat DFn UNTLK => 
H2F TA SACC) HAF UNLSN 


Saves 
This routines saves a section of memory. 
HPF LA SACO) FANT FN2ccee FIN@W1 0837 FNN HREF UNLSN => 


HRF LA SA crf 9914 DI2eee03N 201 DIN—1 HPF UNLSN => 
H2F LA SACC) HRF UNLS* 


Ooens with 3A 
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This routine is used to oven 32 Logical file for 12/0 operations. 


HRF LA SACO) arf FV FN2eeaFNN@W1 e001 FNN HRF UNLSN 


Closes with SA 


This routine is used to clese a Loaical file after all I/0 
aoeratiocns have been comoleted on that file. 


HPF LA SACC) HRF VNUSN 


Chkout): with $4 


This routine must oe called before any data is sent to any 
outout device. 


ARF LA SA 


Chkins with SA 
This routine is called to define any previously opened 
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channel as a input channel. 


MRF TA SA TLKATN 


Chrouts: 

This uses a single character duffers and will 
send previously Suffered characters, if any exists. This 
suffer is also sent alonyz with eoi, orior to sending any 
SERIAL 3US COMMAND sSecuence (€ HRFs, LAse TAv SACD)» SACO), 
SAve UNTLKs UNLSN). 

Cherins 


This routine is called to cet a byte of data from a 
channel already setud as a inout channel. 


08c or eoi DSc C€ if external device sends eoi ) 


- see Chrin - 


Clrenans: 


This routine is useg to clear and restore all open 
Channets to there default values. 


If Chkin channel apen: UNTLK. 
If Cnhkout channel ooen: e01 DSc HRF UNLSN 


Clalls: 
- see ClrecrAn - 
Stapp: 


This routine is used to detect the ston key. If stoo 
key downs Clrchn called. 
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11.5 S3URST COMMANDS ADDED TO DOS 2255 


NOTES PREFIX = "U0" 


C¥4D 4 N = “£TER00COx = ourst read cmd. 
PREFIX#N#TT#SS NN ONT 

switchs T evecacscvesee Transfer d3ta = J 

GF eoccccccsece Lanore Error = 1 

2 


ecovuvcccceonne suffer Transfer Only = 1 
KX eeccscccence OFIVE Number. 


inouts: TT acvcoacaseces Destination track. 
SS coecccesscee Destination sector. 


tt=7 


MN ececcsccecoevcece Number of sectors to be read. 


NT eee O90C coos KOxt track address. 


Sutnut:s Status oyte + data C3urst). 


C™D 2 N = ZTESQ09001x : Surst write cnd. 
PREFIX*#N*+T TESS PNNONT 

Switch: T eccceccesecce Fransfer data = Q 

CF ecccesececcace I3nore Error = 1 

a 

x 


ececccccccces BUffer Transfer Only = 1 
@@e0oegqgeeaeeveges#8s#se ea Drive number. 


Inguts: TT ceocccesceecee Destination track number. 

S$ cccccsccsvee Oestination sector. 

NN eccccecsncece Numoer af sectors to be 
written. 

NT eco SOC seeeoe KOxt track address. 

Data (aurst). 


Output: Status byte (burst). 


ei OO. ms 
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CMD 3 N = XXXX0O010x 


PREFIX EN 


inout: x 


CMD 4G N = APXXUQ11x 


Outputs Status DSyte Cbhurst). 
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* Inquire diskette typde. 


Drive Numder. 


: Format diskette 


PREFIXENS4DOFCOFSZHL TENS HSTHS+FL ( MEM ) 
PREFIX*N#4OS+LIOT4FID2 (5CF) 


switchs p 


inputs WD 
x 


te MFM Ca-f) 
a) CP 
b) 32 


c) LT 
qd) NS 


e) ST 
f) S$ 
q) FL 


GCR 
a) ID1 
do) Ibe 


outputs: NONE. 


ope 
oot 


oot 
opt 


opt 
opt 
Apt 


Partial Format = Q 


Moces, GCRELOXXXXXXX »-MEN=Z10090000 
Drive Numbere 


COo/™ Interleave (def 5) 
Sector $12¢. 


X¥O09000000 = 128 
4290000991 = 256 Default. 
*¥OC000010 = 512 
49090000911 = 1624 


Last track number (COef 39). 
Numoder of sectors oer track. 


(Cefault depends on sector size) 


Starting track (Def 0) lLovcical. 
Starting Offset (Def 0) physical. 
FILL Syte CDef S$e5). 


Identification byte low. 
Identification byte high. 


we with the P bit set the format will end at LT and 
track LT+1 wilt pone cleared CUFM only). 
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c4D 5 N = 2WxXKXU19Ox : Sector interleave CP/M. 


PREFIV*NGTT 
saitcn Tl sveseeeceeece. TRanster cata = A 


inout: w e@ee@eed¢e@esenseceeseeaeneest @ write = rz 
XK eeeeveecnanvnenneeen \rpive suTrbvcef. 
LT wee~eebs@ieeeceew LNter leave. 


cutcut: wWitn the « a3t set CP/% interleave is sent 
3S 3 burst cyt?2e 


C42 & N = 4XXXUTI1x s jtuery cisk format. 
PICFIXYN 


inout: XR eaeceaeseanneeavnennane Jrive Number . 
Outout: Status Fyte (309 » MFM). 
status wyte (¥F™)., 
Mumcer of sectors. 
Locical Track. 
“ininum sectsr numoer. 
Saximnum sector nunser. 
CP/*” Interleave. 
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CMD 7 N = “WXXO11Cx. 
POEFIX+NGS 
switch: T 


Inputs x 


: @@eeaoeeee#eseseaeedgaeese @ @ 


Rit cleared status 


Outouts with the « 
as a buFSt byte. 
C4D & N = SXXX5111x 
PREFIX NH 
inout: x 


“9 @®eege@aaeseeneseaeesweeaoe7e sd @ 


outputs None. 
cno Ss MN = 45977212011 
YP ene ry 
Outputs None. 


inouts IN 


102 


Page 11-10 


: Inquire S3tatuSe 


Transfer data = 9 


Orive Nunber,. 
arite = G 
aith WwW bit set S$ is new status. 


is sent 


s tackuo Jisk (2-drive only) 


Tarset Orive. 


Moce => $0 = MFM, 09 = GCA. 


s Sector Interleave C9. 


Interleave (sef. 16). 
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BREAK DOWN OF STATUS &YTE 


MEM 


Pase 
“D ON I1 I2 01 O2 93 04 
MD escosnacasace NOC? 1 = MFM, 0 = GCR. 
ON) 6:6 ea o°e.e awceveves rive MUMO2@P. 
IT1s 12 eeccesee SEOCtOF Size. 
a) CCG = 122 bytes 
mn) Of = 254 bytes 
c) 12 = 512 oytes 
d) 11 = 15254 pndytes 
D1-04 eeccceese Controller Status 
3Oox = Ok. 
0319 = Sector not faunce 
u911 = No Synce 
9199 = Xata olock not found. 
C101 = Data atock checksum. 
O119 = Format error. 
3111 = Verify error. 
19009 = write orotect error. 
1501 = weader olockx checxsum. 
1910 = Bata extends into next 
nlock. 
1011 = Disk 10 nismatch/D9isk cnance. 
1109 = Unused. 
1191 = Unused. 
1119 = Syntax. 
1111 = No Orive oresent. 
J00x = Gk. 
C919 = Sector not found. 
3011 = So address mark. 
Q100 = Unused. 
G11 = Oata CRC error. 
0119 = Format error. 
S111 = Verify error. 
1909 = Write crotect error. 
1961 = Headger CRC error. 
139123 = Unused. 
1911 = Sisk change. 
1100 = Unused. 
11C1 = Unusea. 
1110 = Syntax. 
1111 = No Drive prasent. 
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REARVWSSETIAS 


0000 
0001 


0002 
0003 
0004 
000s 
0006 
0007 
0008 
00093 


0009 
0009 
000A 
0008 
000C 
0000 
OOOE 
OO0F 
0010 
0011 
0011 


0013 
Q014 
0014 
0015 


0016 
9018 
0019 
0018 
0024 
0024 


0028 
0029 
OO2ZA 
OO0ZA 
0028 


0020 
00 2F 
0031 
0033 
60035 
0037 
0039 
0038 
0030 


d6510 
r6510 


bank 
pc _ ni 
pc_lo 
s_reg 
areg 
x_ reg 
yireg 
stkotr 


integr 
charac 
endecnr 
trsoos 
verck 

count 

diaflg 
valtyp 
intflg 
garbfi 
dores 

subfilg 
inoflg 
domask 
tansgn 
channl 
poker 

Llinnum 
teappt 
lastpt 
teapst 
index 

indexl 
index2 
resho 

resaron 
addend 
resmo 

reslo 


txttab 
vartab 
arytab 
strend 
fretao 
frespc 


max _sea_l 


curlin 
txtptr 


C712 8 


MEMOR Y MA? SRSERRRERBSE 


36510 data direction register 
76510 data register 


smonitor & long call/jump registers 


basic zp storage 


ssearch character 

sflag: scan for quote at end of string 
sscreen coluan from last TA8 

sflag: O=LOAOD, L=VERIFY 

sinout buf.otr / # of subscrionts 

sflag: default array dimension 

*data type: S$ff=string, $00=numeric 

sdata types S0d0=float.pt, $80=integer 
eflag: OATA scan / LIST quote / Garb.coll. 


sflag: subscript ref. / user funce call 
sflag: SOO=INPUT, $40=GET, S$98=READ 


sflag: TAN sign / comparison result 


steap integer value 
spointer: temp string stack 
slast temp string address 
sstack for temp strings 
sutility painter area 


sfloat.eote product of sgultiply 


spointer: start of BASIC text 

spointers start of SASIC variables 
spointers start of BASIC arrays 

spainter: end of BASIC arrays + 1 
spointer: bottom of string storase 
sutility string pointer 

stoo of string/variable bank Cbank 1) 
scurrent BASIC Line nuaber 

epainter to basic text used by crrgeteetc. 


00 3F 
00 3F 
0041 
0043 
0045 
0047 
0049 
0049 
0048 
0048 
0048 


0040 
0040 
O04F 
0050 
0050 
0050 
0052 
0055 
00564 
0058 
0059 


OO5A 
005A 
oosCc 
OOSE 
OOSF 
0061 
0061 
0061 
0062 


9063 
0063 
0063 
0063 
0064 
0054 
0065 
0086 
0066 
0067 
0068 
0069 
0069 
006A 
0068 
006C 
0060 
QO06E 
006F 
0070 
0070 


form 
fndpnt 
datlin 
datotr 
inpetr 
varnaan 
fdecpt 
varpnt 
lstpnt 
andmsk 
forpnt 
eormsk 
vartxt 
opptr 
opmask 
grbont 
teapf3 
defpnt 
dscpnt 
helper 
jmper 
oldov 
tenofl 
etargl 
ptarg2 
stri 
str2 
positn 
match 
arypnt 
highds 
hightr 
tanp f2 
deccnt 
grbtop 
dptflg 
lowtr 
expsgn 
tenexp 
fac 
dsctao 


left_flag 


facexp 


right_flag 


facho 
facmoh 
indice 
facmo 
faclo 
facsgn 
degree 
sgnflg 
argexp 
argho 
argaoh 
argmo 
arglo 
argsgn 
strngl 
arisgn 


sused by print using 

spointer to ites found by search 
ecurrent DATA line numbder , 
scurrent OATA item address 
svector: INPUT routine 

scuerent BASIC variable name 


spointer: current SASIC variable data 


spointer: index variable for FOR/NEXT 
=forpntel 


sflags ‘help® or tlist! 


=temp fl 

=stempfl+¢2 
stempf1+4 
ztempfi+T 
=tempf1+410 
zteapflell 


smultiply defined for instr 


zasdeccnttl 


spaint-Llaeft flag 
sFAC#1 exponent 
spaint-right flag 
sFAC#1 mantissa 


sFACB81 sign 
200inter: series-eval. constant 


sFAC#2 eaexponent 
sFACH2 mantissa 


>FAC#2 sign 


sSign comparison result: FAC8l vs #2 


0071 
0072 
0072 
0072 
0072 
0074 
0076 
00TT 
OOT7 
0077 
0078 
0078 
0079 
OO7A 
0070 
OO7F 
0080 
0080 
0081 
0082 


0083 
0084 
0085 
0086 
0087 
0089 
0088 
Q08sc 
OOSE 
00 8F 


0090 
0091 
8092 
0093 
0094 
0095 
0096 
0097 
0098 
0099 
009A 
0098 
009C 
0090 
O09E 
COQ9IE 
009F 
009F 
0040 
00A3 
0043 
QOA4 


facov 
strng2 
polypt 
curtol 
fhufpt 
autine 
avdflg 
noze 
spernus 
keynuan 
hulp 
keysiz 
syntep 
dsdesc 
tas 
runaod 
parsts 
point 
parstx 
oldstk 


colsel 


aulticolor_l 
multicolor _2 
foreground 
scale_x 
scale_y 


stapnb 
graont 
vtempl 
vtesp2 


pentr 
bsourl 


sFACR#1 low-order Crounding) 


spointer: cassette buffer 
since val for auto CO=o0ff) 
>flag if 10k hires allocated 
susing's leading zero counter 
smovspr & sprite temporary 


scounter 


sused as temp for indirect loads 
>descriptor for ds$ 

ston of run time stack 

>flags run/direct anode 

7d0s parser status word 

susing’s pointer to dec.pt 


H graphic zp storage 


scurrent color selected 


;scale factor in x 
sscale factor in y 
*stop paint if not background/not same color 


>; kernal/editor allocations start nere 


71/0 operation status byte 
sstop key flag 

stape tenporary 

slLoad or verify flag 
>serial buffered char flag 
schar buffer for serial 
scassette sync & 

stemp for basin 

sindex to logical file 
sdefault input device # 
sdefault output dewice #% 
scassette parity 

scassette dipole switch 
sos sessage flay 

scassette error passil 
stemporary I! 

>Cassette error pass2 
stemoorary 2 

>24 Nour clock in 1/60th seconds 
‘serial bus usage 
sCassette stuff 

stemp used by serial routine 


OOA4 
0045 
0045 
0046 
QOOQA?7 
OOQA7 
O0A8 
0048 
0049 
00A9 
OOAA 
OOAA 
O0A8 
OO AE 
QGAC 
O00A0 
OOAE 
OOAF 
0080 
0081 
0082 
0084 
0084 
0085 
0085 
0086 
0086 
0087 
0088 
0089 
OO8A 
00388 
0036 
0030 
OOBE 
O08F 
OO8F 
00Cc0 
00c1 
O0cl 
@0C2 
60C2 
00C3 
00C3 
00C5 
00Cé 
o0c? 
oocs 
OOCA 


firt 
count 
cntdn 
bufpt 
inbit 
shcnl 
bitci 
rer 
rinone 
rez 
ridata 
rdflg 
riprty 
shcnh 
sal 
sah 
eal 
eanh 
cmp0 
temo 
tapel 
bitts 
snsuli 
axtbit 
diff 
rodata 
erp 
fnien 
la 

$a 

fa 
fnadr 
raorty 
ochar 
fsblk 
drive 
maych 
casl 
track 
stal 
sector 
stah 
gaeauss 
tmp2 
data 
ba 
fnbank 
ribuf 
robu f 


stemo used by serial routine 
scassette syne countdown 

scassette buffer pointer 

srs-232 revr input bit storage 
scassette snort count 

s$res-232 revr bit count in 

scassette read error 

ses~-232 revwr flag for start hit check 
scassete reading zeroes 

ses7232 revr byte buffer 

scassette read mode 

2es-232 revwr parity storage 

scassette short cnt 

spointer: tape buffer / screen serolling 


stape end addresses / end of program 
stape tiwing constants 


saddress of tape buffer 
7Fs-232 tras bit count 


sPs-232 trns next bit to be sent 
oes-232 trns byte buffer 


slength current file n str 
scurrent file losgical addr 
scurrent file 2nd addr 
scurrent file primary addr 
saddr current file name str 
2rs-232 trns parity buffer 


scassette raad block count 


sserial eord buffer 
scassette manual/controlled switch Cupdated during 


71/0 start address Clo) 


5 * * Crt) 
scassettea load temos C2 bytes) 


stape read/write data 

sbank for current load/save/verify operation 

sbank where current filename is found Cat ‘fnadr') 
7res-232 input buffer pointer 

sPs-232 outout buffer pointer 


irq) 


s; £0780 colunn 


§S CR EEN EotrI TOR declarations 


¢ GLOSAL screan editor variables 


keytab 
imparm 
ndx 
kyndx 
keyidx 
shflag 
sftdx 
lstx 
crss 
sode 
graohe 
charen 


’ the 


sedsal 
sedeal 
sedtl 

sedt2 

keysiz 
keylen 
keynum 
kaynxt 
kaybnk 
keytsp 
bitmsk 
saver 


screen editor 


pnt 
user 
scbhot 
setoop 
sclf 
scrt 
lsxo 
lstp 
indx 
tbix 
pntr 
lines 


coluans 


datax 
lstenhr 
color 
tceolor 
rvs 
ats 
insrt 
insflg 
locks 
scroll 


skeyscan table pointer 

sPRIMM utility string pointer 

>index to keyboard queue 

spending function key flaq 

sindex into pending function key string 
skeyscan shift key status 

sKkeyscan current key index 

skeyscan last key index 

><cr> input flag 

$40/80 colunn mode flag 

stext/graonic mode flag 

srpam/rom vic character character fetch flag Cbit-2) 


following locations are shared by several editor routines 


pointers for MCYLIN 
SAVPQS 


oprograwmable key variables 


stemporary for TAS & lina srap routines 
syet another temporary placa to save a register 


variables (Csmsapped-out shen 40/80 MODE changes) 


spointer to current line Ctext) 

spointer to current line Cattribute) 

swindow lower limit 

swindow upper Limit 

sWindow left margin 

sBindow right margin 

scurrent input colunn start 

scurrent input line start 

scurrent input line end 

current cursor line 

scurrent cursor colunn 

sMaximum number of screen lines 

smaximum number of screen coluans 

current character to print 

sprevious' character printed Cfor <esed> test) 
ecurrent attribute ta print Cdefault fond colar) 
ssaved attribute to print Cfinsert® £ tdelete®) 
sreverse mode flag 

*Quote mode flag 

sinsert aode flag 

sauto-insert mode flag 

sdisables <e=><shiftd, <etr lL>—§ 

sdisables screen scrolls Line linkaear 


Q0FS beeper >disables <ctrl>-G 
OQFF lo fbu f 


s MONITOR zero page stuff 


peb = $02 
ach = $03 sin basic’s area 
pel = $064 
flgs = $05. 
acc = $06 
xe = $07 
yr = $08 
$p = $09 
txtptr = $7a 


suse basic fac for manitor 2p 


0060 t0 42443 
0063 t! $=343 
0066 t2 4=%3 


$ basic/dos interface vars 


0100 fbuffr sarea to build filename in 
0110 xent >dos loop counter 
0i11 dosfil sdos filename 1 len 
0112 dosdsl sdos disk drive 1 
0113 dosfla 7dos filenane 1 addr 
0115 dosf2i sdos filename 2 len 
0116¢ dosds2 2>d0s disk drive 2 
0117 dasf2a ;dos filename 2 addr 
0119 dosofl sbload/bsava starting addr 
0118 dasofh seeand bsave’s ending addr 
0110 dosla °dos logical addr 
O11€E dosfa sdos phys addr 
O11F dossa *dos sece addr 
0120 dosrcl >dos record length 
0121 dosbnk 
0122 dosdid *dos dsk identif. 
0124 didchk sdos did flg 
° Space used by PRINT USING 
0125 bar spaintear to begin. no. 
0126 enr spointer to end no. 
0127 dolr sdollar flaj 
0128 flay 7comma flag 
01°29 sue scountear 
012A usgn sSlLaAN expanent 
0128 ue@xp spointer to exponent 
012C wn s# of digits before deciaal point 
0120 chsna sjustify flag 
01 2¢ vf ># of °pas bafore decinal onaint Cfield) 
012F nf >*# of pos aftar decimal point Cfield) 
0130 poso s+/- flas Cfield) 
0131 teso seaxponent flag Cfield) 
0132 etof >sweitch 
0133 cform echar counter Cfield) 
0134 sno ;$i3n no 
9135 blftd sblank/star flag 
§136 bagfd so0inter to begin of field 
0137 lfor slLength of format 
0138 endfd spointer to and of field 


0200 


O2A2 


O2AF 


Q238E 


02C0 


O02E€3 


0314 
0316 
0318 
O3Z1A 
031C 
O31€ 
0320 
0322 
0324 
0326 
0328 
O32A 
032C 
O32E 
0330 
0332 


0334 
0336 
0338 
Q33A 
033C 
033€E 
034A 
0354 
O35€ 
0362 
036C 
0376 
0380 
0386 
0390 


039F 
0348 
0337 
03C0 


bu f 


fetch 
fetvec 


stash 
stavec 


cmpare 
cmpvec 


jsrfar 


jepfar 


Lirg 
ibrk 
inai 
iopen 
iclose 
ichkin 
ickout 
icirch 
ibasin 
ibsout 
istop 
igetin 
iclall 
@axmon 
iload 
isave 


etlvec 
sh fvec 
escvec 
keyvec 
keychk 
decode 
keyd 
tabmao 
bitabl 
lat 
fat 
sat 
chroet 
chrgot 
qanum 


indsub_raad 
indsub_raal 
indinl_raal 


indin2 


sinout buffer Cused by basic & monitor) 


LOAC-)ey from any bank 
fetched 


STAC=)ey to any bank 
stash+19 


sCMPC-)ey to any hank 
= cmpare+10 


*JSR xxxx to any hank & return 


eJM> xxxx to any bank 


: conforms to karnal spec 8/19/30 


smonitor comaand indirect 


editor indirect vectors 


>aditor: print ‘contrl!® indirect 
seditor: print 'shiftd® indirect 
>eaditor: print ‘escape’ indirect 
,aditor: keyscan logic indirect 
se@ditor: store key indiract 
svectors to keyboard matrix decode tahles 
‘irq keyboard buffer 

shitmap af tab stoops 

sbitmap of line seraps 

slogical file numbers 

sprimary device nuabers 
ssecondary addresses 


: indirect load subroutine area 


>shared rom fetch sub 
*>shared rom fetch sub 
sindexl indirect fetch 
>index2 indirect fetch 


03C9 
0302 
03955 
0306 
0304 
0308 
030F 
03€0 
031 
O3E2 
03€3 


PAGE FOUR & HIGHER 


0400 


0a00 
OA02 
0A03 
0A04 
0A05 
OA07 
0A09 
QA0B 
OAOC 
0A00 
OAOE 
OAOF 
0A10 
OAll 
OAlL2 
0A14 
OA15 
0A16 
QA18 
QA19 
OALA 
OA1B 
OA1C 
OAL 


indtxt 
zero 


current _bank 


tmodes 


fin_bank 


$avsiz 
bits 


sprtsao_l 
sprtmo_2 


fg_b¢ 
fg_acl 


vicscecn 


x = $0800 


stxtptr 

sNAumeric constant for basic, downloaded from rom 
scontext for SYS,POKE,PEEK. Set by 3ANK command. 
stemp for instr 

sbank pointer for string = number conversion routine 
stenp work locations for sshape 

sFAC#1l overflow digit 

stemp for soersav 


spacked foreground/background color aybbles 
spacked foreground/multicalor 1 color nybbiles 


declarations (xx*%*%x heginning of bankable ram *3%*#%3) 


svVideo matrix ?1:3 vic 40-column text screen 


sbasic run-time stack (€512 bytes) 


H ABSOLUTE kernal variables 


system_vectorsvector to restart system Cusually BASIC warm start) 


dejavu 
palnts 


init_status 


gaeastr 
memsiz 
iraqtmup 
caston 
kika26 
stupid 
tinout 
enabl 

asSiletr 
asicdr 
eSlajb 
rsstat 
bitnum 
baudo f 
ridbe 

ridbds 

rodbs 

rodbe 

serial 
tiszer 


skernal earm/cold initialization status byte 
spal/ntse systea flas 

sflags reset vs. nmi status for initialization routine 
pointer to bottom of available menory in system bank 
pointer to top of available memory in system bank 
stape nandler preserves irg indirect here 

stod sense during tape operations 

stape read temporary 

stave read dlirqa indicator 

sfast serial timeout flag 

ses-232 enables 

2sP$-232 control register 

srPs-232 command register 

2Ps~-232 user baud rate 

sPs-232 status register 

sFS$~-232 number of bits to send 

sP$-232 baud rate full bit time Ccreated by OPEN) 
sesw-232 input buffer index to end 

7PS$-232 input buffer index to start 

sP$-232 autput buffer index to start 

srs-232 autput buffer index to end 

sfast serial internal/external flag 

,decrementing jiffie register 


0A20 
OA2Z1 
OA2Z2 
0A23 
0424 
0A25 
0A26 
OA27 
0A28 
OA29 
QOA2A 
0A28 
OA2C 
0A2D 
OA2E 
OA2F 
0430 
OA31 
0A32 
0433 
0434 
0A35 
0A 36 
0A37 
0A38 


0A80 
OAAD 
QAAA 
OAAB 
QAAC 
OAAF 
0A80 
0a8sl 
QA82 
6483 
0A54 


OACO 
OAC1 


0800 
oc00 


0000 


xmax 
pause 
rptflg 
kount 
delay 
lstsnvf 
blnon 
binss 
binct 
gdbin 
gdcol 
curaod 
val 
va2 
va3 
ves 
lintmp 
sav80a 
sav30b 
sav80c 
sav30d 
curcol 
solit 
fnadrx 
palecnt 


xcnt 
hulo 
forrat 
length 
asal 
sxreg 
syreg 
srap 
xSave 


direction 


tesgps 


curbnak 
pat 


tbuffr 
es232i 


rs2320 


* = $0200 


* = $1000 


pk ynuan 


GLOSAL 


A3SSULUTIE 


screen editor declarations 


skeyboard queue maximum size 
s<etrlo-S flag 

senable key repeats 

sdelay between key repeats 

sdelay before a key starts repeating 
sdelay between <C=><shrft> toggles 


swic 
svic 
svic 
svic 
evic 
swde 
swic 
svic 
svdc 
svde 


* @ 


cursor 
cursor 
cursor 
cursor 
cursor 
cursor 


mode Cbhlinking, solid) 
disable 

blink counter 
character before blink 
color before blink 


mode Cwuhen enabled) 


text screen/character base pointer 
bit-e@ao base pointer 

text screen base 

attribute dbase 

stemporary oointer to last line for LOOPS 
$22777277? temporary for 30-col routines 
$22772727?2? for B80-col routines 


temoorary for 


mowlin/clrlin 8563 kludge 


svde cursor color before blink 
>vVic split screen raster value 
eX during bank operations 
scounter for pal systems Cjiffie adjustment) 


2save 


s monitor's domain 


scompare buffer 


s,asa/dis 
efor assembler 

s1 byte temp used all over 

sl byte temp used all over 

>i byte temp for assembler 

oX here during indirect subroutine calls 


sSave 
sdirectiaon indicator for 


‘transfer! 


s FUNCTION KEY ROM CARO tables 


scurrent function key rom bank being polled 
sohysical address table Cid's of logged-in cards) 


scassette buffer 


3r7s-232 input buffer 


7PS$~-232 output buffer 


ssorite definition area 


4 


Caust be below $1000 !1) 


>programaable function key definitions 


=10 


snumber of definable keys 


Cfl-f8, €svrftorun, 


Help. 


1000 
100A 


1100 


1131 
1131 
1131 
1133 
1135 
1137 


1139 
1139 
1134 
1130 
1138 
113¢ 
1141 
1145 
1147 
1148 


1149 
114A 
114C 
114¢ 


1150 
1152 
1154 
1156 
1158 
115C 
L15€ 
1160 
1142 
1164 
1166 


pkybdu f 
pk ydef 


dosstr 


veork 
xy pos 
xpos 
ypoas 
xdest 
ydest 


xyabhs 
xabs 
yabs 
xysgn 
xsgn 
ysgn 
fect 
errval 
lesser 
greatr 


angsgn 
sinval 
casval 
angent 


xcircel 
ycircl 
xPadus 
yradus 
ratang 
angbeg 
angend 
XPCOS 
yrsin 
xrsin 
yrcos 


sprogranmable function key Lengths table 
sprogrammable function key strings 


#2$1100 >dos/vsp area 
*d0s output str. buf 
sarea to build dos string 


s graphics vars 


scurrent x nesition 
scurrent y position 
sx~coordinate destination 
sy~coordinatea dastinatien 


> line drawing variables 


> angle routine variables 


ssign of angle 

ssine of value of angle 

s€osine of value of angle 

stemps for angle distanca rautines 


the following 24 bytes arr nultinly defined, beginning on 
this pages, and continuing for the next & pages. 


> Circle drawings variavlas Cmultinly defined) 


scircla center, x coordinata 
circle conter, y cr0rdinate 

sx radius 

7yY Padius 

sPFotatian angle 

sarc angle star 

sare angle end 

27k radius * cosCrotation angle) 
*y eadius = sin rotation angle) 
*xX Padius * sinCrotation angle) 
>y eadius * cos(Crotation angle) 


; general use parameters Cmultioly defined) 


1150 
1152 
1154 
1156 
1158 
LISA 
115C 


LISE 
115F 
1160 


1150 
1152 
1154 
1156 
1158 
L1iSA 
115C 
115€ 


xcentr 
ycentr 
xdistl 
ydistl 
xdist2 
ydist2 
disend 


caolent 
rowcnt 
strent 


xcordl 
yeordl 
boxang 
xcount 
ycount 
bxleng 
xcord2 
yeord2 


splaceholder 
schar®s cole counter 


¢: box drawing variables Cmultiply defined) 
speaint 1 x-coord. 


spoint 1 yr~coord. 
»sretation angle 


slength of a side 


1151 
1152 
1153 
1154 
1155 
1156 
1157 


1159 
1158 
1150 
115F 
1161 


1168 
1169 
116A 
11458 
116C 
1160 
L16E 
L16F 
1170 
1172 
1174 
1175 
1177 
1178 
1179 
11iTA 
117C 
L17€ 
1106 


keylen 
kKeynxt 
strsz 

gettyp 
stroptr 
oldbyt 
newbyt 


x$izea 
ysize 
xSave 
stradr 
bitid~x 


chrpag 
bitent 
scalen 
width 

filflg 
bitask 
nuacnt 
treflg 


renua_tmo_l 
renum_tap_2 


t3 

t4 

vteap3 
wtemos 
vtesgs 
adrayi 
adray2 


sprite data 
vic_save 
init_as_9 


s shape and move-shape variables Cnultianly defined) 


splaceholder 


string len 

sreplace shape szo0de 

sstring pos'n counter 

sold bit sao byte 

snes string or bit map byte 
solaceholder 

s>shape column length 

sshape row Length 

stemp for column length 
ssave shape string descriptor 
sbit index into byte 


$s graonhic variables 


shigh byte of address of char rom for ‘chart cmd. 
stemp for gshape 

sscale mode flag 

sdeuble width flag 

sbox fill flag 

stemp for bit aask 


sflags trace made 
-a temp for renusber 
7a teap for renuaber 


graphic temp storage 


sptr to routine: convert float -> integer 

sptr to routines convert integar -> float 
sspeed/direction tables for sorites 

scooy of vic reg's, used to update chip during retrace 
*R-sgporite_data-1 sjust a count for init 


1200 
1202 


1276 
1279 


> generar._basic non-zp storage 


aldlin previous SASTC line number 
oldtxt spointers BASIC statement for CONTINUE 
> daclarations for sorint using 
psuchrs 
pufill serint using fill symbol 
pucomga sprint using comma symbol 
pudot sprint using deo. symbol 
pumony sprint using monetary symbol 
errnua sused by error trapping routine-last error 
errilin slLine # af last error - ffff if no error 
traono s line to go to on error.e ffxx if none set 
tmotrp shold trap # tempor. 
errtxt 
text top stan of text pointer 
max_men_0 ehighest address available to BASIC in ran 
tmotxt sused by do-loope could ba mult. assigned 
taplin 
usrpok 
rndx : 


circle_segaent 
dejavu 


sdegrees par circle sagment 
s*cold®* or ‘warm? reset status Caust be in 


s music stuff 


tempo _rate 
voices 
ntime 
octave 
sharp 
pitch 
voice 
waved 
dnote 
fltsav 
fitflg 
nibble 
tonnun 
tonval 
parcnt 
atktab 
sustab 
savtab 
pulsle 
pulshi 
filters 


° interrupt stuff 


int_trip_ flag 
int_adr_lo 


nusber 


oase 51) 


127C 
127F 
1230 


1231 
1282 
1235 
1288 
12388 
128€ 
1291 
1294 
1297 
129A 
129C 
1240 
12A3 
1244 
1245 
1246 
12A7 
1248 
1249 
12AA 
1248 
12AC 
1240 
L2ZAE 
12AF 
12590 
1281 
1282 
1283 
1287 
L2FA 
12F8 
12FC 


int_adr_ni 
intval 
coltyp 


s SOUND command stuff 


sound voice 
sound _tisge_lo 
sound time hi 
sound_smax_lo 
sound _max_hi 
sound _min_lo 
sound smin_hi 
sound directian 
sound_step_lo 

sound step_hAi 

sound. freaq_lo 

sound freq_hi 

temp_time_lo 

teap_time_hi 

teap_max_lo 

temo _max_ hi 

teap_min_lo 

temp_min_hi 

teap_directian 

tano_step_lo 

temp_step_hi 

teap_freq_lo 

tenp_freq_hi 

tesp_pulse_lo 

teap_pulse_hi 

teap_wavefors 

pot_temp_l stemporarys for 
pot_teso_2 
sindouw_temp 
savran é 
defmod ; 
lincnt : 
sorite_nuaber 


U 


‘Port 


function 


ed by SPROEF & SAVSPR 


1C00 


FFFS 


* = $1100 
* = $1200 
+ = $1300 
+ = $1800 
# = $1¢00 
rambot 

% = $2000 
* = $4000 
* = $ff05 
* = $ffdd 
e = $fff5 
locker 

%* = $fffa 


7cp/m reset codts basic dos & vsp variables 

sbasic absolute variables 

s;uNallocated absolute ran 

sreserved for function key softsare applicatisns 
svideo matrix #2 C1K5, bitmap color, if allocated) 
sbasic text starts here Ckernal sets ‘menbot® herrea) 
svic bitmap C8KB8, if allocated) 

sSERSRIERARSE Heginning of rom over Fam KRRKASZRRKIVESE 
skernal interrupt ram code here Call ram banks) 


sco/m transfer-processor-control ram code here 
; Cfirst ram bank only) 


s*CBM*® key goes here in rant 


skernal hardware interrupt ram vectors here 
; Call ram banks) 


KFOO 
AFO3 
AF O6 
AFO9 
AF OC 
AF OF 


AF12 
AF1S 
AFB 
AF18 
AFLE 
AF21 
AF24 
AF27 
AF 2A 
AF 20 
AF30 
AF 33 
AF 36 
AF 39 
AF3C 
AF 3F 
AF 42 
AF 4&5 
AF S83 
AF 4B 
AF GE 
AFS1 
AFSS 
AFS7 


AFSA 
AFSC 
AF 60 
AF4S3 
AF 66 
AF69 
AF 6C 


AF AF 
AF 72 
AFTS 
AFT 
AFT 
AFTE 
AF 81 
AF 34 
AF 37 
AF AA 


VISITS SAAS SSS 


8AS TC 


8104 
7800 
8859 
7087 
8535 
898C 


854E 
3551 
8565 
2568 
8744 
8747 
8860 
8863 
86EA 
BAl2 
8CCE 
8011 
ecos 
8C08 
RO4A 
9122 
9129 
9172 
91CC 
895E 
8998 
894¢c 
B9II9E 
8157 


8703 
87A8 
7956 
88&3 
8917 
893F 
894F 


4802 
9849 
9914 
66A2 
5A18B 
S1A0 
S1A5 
9183 
S4E*F8 
42F0 


jmp 
jmp 
Jp 
jmp 
jmp 
jap 


jap 
jmo 
jap 
jap 
jmp 
jmp 
jmo 
Jao 
jmp 
329 
jp 
jap 
jmp 
jmp 
jnp 
jp 
jmp 
jmp 
jmp 
jmp 
jsp 
jip 
jmo 
jap 


J 


U M P 


ayint 
sivay f 
fout 
val_1t 
getadr 
floatc 


fsuh 
fsub 
fadd 
fadd 
fraul 
fmul 
fdiv 
fdiv 


> Math Functions 


t 
t 
t 
tt 


t 


lag 
int 
sar 
negoo 
four 
fowrt 
exp 
cos 
sin 
tan 
atn 
round 
abs 
sign 
fcomo 
rnd_Q 


> Movesent 


jap 
jmo 
jap 
jmp 
jug 
jap 
jmp 


jap 
jmp 
jno 
jJ%p 
jap 
jmp 
Jno 
jmp 
jap 
jmp 


Taae 


> Foraat Conversians 


NNNNANNANNANAANN 


sconvert 
>convart 
scaonvert 
sconvert 
,convert 
>convert 


;MEM 
7 ARG 
;MEM 
SARS 
sMEM 
SARG 
;MEM 
SARG 


NN 8 tt oe | 


fe0< 
feDe 


f.p. 


to intecer 
integer to f.ne 
to ascli string 
ascli string to f.od. 
to an addrass;s 
address to f.p. 


FACC 
FACC 
FACC 
FACC 
FACC 
FACC 
EFACC 
FACC 


scompute natural log of FACC 
sperform basic [NT on FACC 

scompute square root of FACC 
snagate FACC 
>raise ARG to the MEM power 


>Paise ARG toa 
scompute 
;conpute 
scompute 
scaonpute 
scompute 
sraund FACC 
sabsolute value 
stest sign of FACC 

scompare FACC with MEM 


>generata randosa f.p. 


conupk 
romuok 
movfra 
movfa 


aovn 
mov f 
gova 


f 
4 
f 


ostab 


draw 


In 


golot 
cirsub 


run 
PUNAC 


clear 


New 


Inkorg 
CrRunAnch 


RAM 
ROM 
RAM 
ROM 


>move 
ROVE 
> ROVE 
>move 
>move 
*nOove 
ROVE 


EXP 
COs 
SIN 
TAN 
ATN 


MEM 
MEM 
MEM 
MEM 


FACC to 
ARG to FACC 
FACC to ARG 


the FACC power 


t~9 
to 
t5 
to 
Me 


FACC 
FACC 
FACC 
FACC 
FACC 


of =acc 


number 


ARG 
ARG 
FACC 
FACC 
mM 


AFSC 
AF9Q 
AF93 
AFIE 
AFI9I 
AFIC 
AFOF 
AFA2 


$010 
4A00 
TTA8 
T6C0 
4A00 
SA01 
504C 
90093 


jmp 
jp 
jup 
jap 
jmp 
jmp 
jmp 
jmp 


fndlir 
nesstt 
eval 

frmavl 
newstt 
sataxec 
linget 
garba2 


C000 
C003 
C006 
C00S 
CoOC 
COOF 
C012 
C015 


CO1a 
core 
COLE 
C021 
C024 
C027 
CO2A 


C020 


4C 
4C 
4C 
4C 
4C 
4C 
4C 
4C 


4C 
4C 
&C 
4C 
4C 
4C 
4C 


4C 


PISS SAISAAS SASS 


C078 
CC1A 
C217 
C27E 
C713 
CC41 
C549 
C544 


CC4é 
CO17 
C9AF 
CC62 
Cisc 
cocc 
CCEE 


CA0T 


Jp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jap 


jmp 
jmp 


. Jap 


jap 
jap 
jmp 
j"o 


jnp 


C I rt 72 8 


cint 
disoly 
lpo2 
looa5 
print 
scrorg 
scnkey 
repeat 


plot 
cursor 
escape 
keysat 
ira 
initsd 


suapner 


window 


J~U MP 


TA BL E NNNANNANSNNNANNNANNN 
*initialize editor & screen 

sdisplay character in 2a, color in .x 
>g9et a key from irq buffer into .a 
>get aochr from screen line into .a 
sprint character in .a 

79e@t # of screen rows, cols into .x,.y 
7scan keyboard subroutine 

>Pepeat key logic & *ekit2' 

> to store decoded key 

>rFead or sat crsr pasition in ex» ey 
>nove 38563 cursor subroutine 

sexecute ESC function using cnr in .a 
sredefina a procgraamable function key 
,irq entry 

sinitialize 80-column character set 
>swao editor loc vars 

; €40/80 node change) 

sset toorleft or bot-right of sindos 


SISIAAAAIAS AS IAS SASS It f/ OO O-E VICe MAP §$ NNANNNNNNANSNANAANAS 


vicehr = $d000 swic character ron 

vicreg = $d000 svic registers 

sidreg = $d40G ,;sid registers 

anu_lo = $4500 smmu primary registers 

vde = $4600 38563 registers 

wiccol = $d890 svic color nybbles 

cial = $dc00 56526 #1 

cia2 = $dd00 36526 #2 

iol = $de00 sexpansion i/o slot Creserved) 
io2 $df00 ,e@xpansion i/o slot 


Creserved: aptional OMA ctlr for axpansion ran) 


emu_hi = $ff00 smMmu secondary registers 
> C3*% not in i/o block! ***) 


memory  Banagement unit 
implements ¢c/123, ¢/764, & cpo/m 3.0 modes 


0590 armucrl configuration register Cprimary) 
0501 pera spreconfiguration register a 
0502 perb spreconfiguration register 4 
0503 perce spreconfiguration register ¢ 
0504 perd spreconfiguration register d 
§505 amuncr smode configuration register 
0506 gaurcr sram configuration register 
0507 amupdl spage 0 pointer lows 
0508 maeuo0h >page 0 pointer high 
0509 BMUDLIL spage 1 nointeor low 
DSOA amuplh >page 1 pointer high 
0508 amuver emmu version nuasaber 
s €2** prototype: reset latch *#% 
FFOO amucr sconfiguration register Csecondary ) 
FFO1 lera slaad configuration register a 
FFO2 lerb slLoad configuration register h 
FFO3 lere sload configuration register ec 
FFO4 lerd slLoad configuration register d 
> ¢€/128 80—coluan video display controller 

0600 vdcadr 38563 address register 
0601 vdcdat 23563 data register 

vdesen => $0000 38543 80-column screen C2K8) 

vdecol = $0800 38543 attribute area C€2K8) 

vdecrhr = $2000 +¢85453 character ran C4K3 3 256 cnrsy 32x16) 
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orad 
pral 
pra2 
pra3 
pra 
prad 
pras 
praTfl 


prbd 
prbi 
prb2 
prb3 
prbs 
prebs 
prb6 
prb?7 


6526 cia 


es 0©6@ €6 ©6 660 0660 @¢8 e868 


complex interface adapter #1 
keyboard / joystick / paddles / lightpen / fast disk 


keybd 
keybd 
keybd 
keybobd 
keybd 
keybd 
keybd 
keybd 


keybdd 
keybd 
keybd 
keybd 
keybd 
keybd 
kaybd 
keybdd 


timer 1 & cra 
timer 2 & erbd 


tod 
sdr 
icr 


0c00 
OC 00 
OC01 
OCO1 
0C02 
0C03 
0C04 
0C05 
0C06 
OCO0T 
0C08 
6C09 
OCOA 
OC 08 
Ococ 
ocoCc 
OCOE 
OCOF 


ee 68 06 


colm 
dipora 
roes 
dtprb 
diddr 


output 
output 
output 
output 
output 
output 
output 
eutput 


input 
input 
inout 
input 
input 
input 
input 
input 


« fast disk 


c0 
regp | 
¢2 
¢3 
c4 
cs 
¢§ 
c? 


rd 
ri 
r2 
r3 
r4 
r5 
r 6 
r7 


~~X NN RR NON 


eX XR RN RN NN 


cassette 


diddrb 


ditil 
ditih 
dit21 
dit2h 


keyboard outputs / joystick / paddles / Llightpen 


skeyboard inputs 


ditodi 
ditods 
ditoda 
ditodh 
disdr 
diicr 
dicra 
dilecrb 


joystick 
joystick 
joystick 
joystick 
joystick 


joystick 
joystick 
joystick 
joystick 
joystick 


timer b: 
timer as 


el 
#1 
#1 
#1 
41 


direction 
direction 
direction / 
direction / 
fire button 


~N 


#2 
#2 
#2 
#2 
$2 


direction 
direction 
direction 
direction 
fire button 


~~. N NN 


paddle 
paddle 


select 
select 


paddle 
paddle 


toggl2/pulse output 
toggle/pulse output 


fire 
fire 


port 
port 


fire 
fire 


4 joystick / paddles 


button 
button 


¥1 paddles 
#2 paddles 


button 
button 


ee Se B2e BO Ge BSS O66 BSE SO BE 


ee Be 2S C20 @e oe B® BE Be SO Ge OS BH CGH Be SE Ge 


6525 cia 
port / rs232 / sarial bus / vic 


user 


prado 
pral 
pra2 
pra3 
ora4 
prad 
oprah 
oral 


prbdg 
perbdbl 
prb2 
erb3 
prb4 
orbs 
prbé 
ped? 


e6 26 ©6@ 08 68 286 8&8 88 


complex intérface adapter #2 


vals% 
valsS 


rs232 

serial 
serial 
sarial 
serial 
serial 


user 
user 
user 
user 
user 
user 
user 
user 


port 
por’ 
port 
port 
port 
port 
port 
port 


timer 1 €@ cra $ 
tiger 2 & erb 3° 


tod 
sdr 
icr 


d2pra 
d2prb 
d2ddra 
d2ddrb 
d2til 
dZtlh 
d2tzl 
d2t2h 


dZtodl 
d2Ztods 
dZ2toda 
dZtodh 
d2sdr 
d2icer 
d2cra 
dZgerb 
timrb 


~N 


nai C/ira) 


output 
output 
output 
output 
input 
inout 


rs232 
rs232 
rs232 
rs232 
rs232 


es232 
rs232 


rs$232 baud rate 
rs232 bit check 


memory / nai 


received data 
request to send 
data terminal ready 
ring indicator 
carrier detect 


clear to send 
data set ready 


sserial bus / rs232 / val4,i5 
suser port 


4 7s232 


6526 erd 


enable one-shot tb 


c¢/128 


OMA controller for expansion RAM access 


CXEKPRELIMINARY &3% 


Ceptional device mapjsed into [02 block via system Expansion Port) 


OF090 
OF O01 
DF O02 
OF O03 
OF 04 
OF OS 
OF 06 
DFO? 
OF 08 
OFOS 
OF OA 


dma_st 

dma_cad 
dma_adl 
dma_adh 
dma_lo 

dma_hi 

dma_bnk 
daa_dal 
dma_danh 
dma_sua 
dma_ver 


sOMA 
>OMA 
>1lsb 
sasb 
slsb 
smsb 
754K 
:lsb 
smsb 


controller status register 
controller command register 


of internal €¢c128) address to 
of internal €¢128) address to 
of external expansion ram toa 
of external expansion ram to 


access 
access 
access 
access 


external ram hank 


of byte 
of byta 


;checksua of 


oOMA 


version 


count 

count Cbhlock count) 
last data transfer 
£ memory limits 


999999999999 


eoeoee @8 8 @©@ @ @® © 8 @ 


s; entry definitions for.c/128 EDITOR 


cint = $c000 seditor: initialization 
display = $¢003 s;editor: display chr in «as color in .x 
lp2 z= $c6005 seditor: get a key from irg buffer 
loog5 = $c009 seditor: get a chr from screen 
print = $c00c seditor: print a chr to screen 
scrorg = sc00f saditor: return screen size of local display device 
key = $c012 seditor: general key scan 
reoeat = $c6015 seditor: repeat key losic & *ckit2* 
> to store decoded kay 
plot = $¢018 seditor: read or set cursor position 
cursor = 8c0lb seditor: move 8543 Nardware cursor 
@scaoe = $cOle seditor: escape sequence handlar, chr in ea 
pfkey = $c021 seditor: program function key 
edira = $c024 sSeditor: irq entry 
dichr = 8c027 seditor: doanload 80-col character ras 
swapper = $c02a seditor: swap to alternate display device 
> entry definitions for c/128 4ONITOR 
monitr = $b000 sSmonitor: call entry 
monbrk = $6003 smonitor: brk entry 
aoncad = $b006 smonitor: monitor comagand parser 
> entry definitions for ¢/128 3ASIC 
basic = $4000 s$basic: cold entry 
basics = $4003 sbasic: warm antry 
basira = $4006 sbasic: irq antry 
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snew *jmos* for ¢/128 


FFS&Q jap cé4mode reconfigure system aS a c/64% Cno returnl 
FFSO jap dewga_call sinitiate dma request to external 
+ Pa@ expansion 
FF53 jao boot_call sb00t load program from disk 
FFS6 jap phoenix scall all funetion cards’® 
> cold start routines 
FFS 9 jap lkupia >search tables for given la 
FFSC jap lkupsa ;search tables for given sa 
FF SF jan swapper >sHnap to alternate display dewice Cediter 
FFG&2 jao dlenr siNit 80-col character raa Ceditan 
FF6S jap pfkey sprogram function key Caditor 
FF68 jap setbnk 7set bank for load/save/verify 
FF 6&8 jap getcfg 7convert bank to mmu configuration 
FF6E jao jsetar 7JSR to any bank, RTS to calling bank 
FFT1 jap jaofar + JMP to any bank 
FFT74 jap indfer sLOA Cfetwec),Y from any bank 
FFT? jap indsta SSTA Cstavec),Y to any bank 
FTA juo indenp 7CMP Ceompvec),Y to any bank 
FF 7D jmo pris sprint imsaediate 


> Calways JSR to this routine!) 


FFS3C ebyte 0 sreleasa number of karnal 

FFS)1 jmp cint >init editor & display chips Ceditor) 
FF84 jmp ioinit sinit i/o devices Cports, timers, etc.) 
FFS87 jmp rantas >iLALtLialize ram for systea 
FFBA jap restor srestore vectors to initial systen 
FFS8C jap vector schange vectors for user 

FF9Q jap setuass control O.sSe messages 

FF93 jmp secnd ssend sa after listen 

FFI6G jmp tksa ssend sa after talk 

FF99 jap memtoo ;set/read top of memory 

FFOC jap membot sset/read bottom of memory 

FF IF jmo key sscan keyboard Ceditor) 
FFA2 jap settao sset timeout in ieae Cunused) 
FFAS jap acptr shandshake serial byte in 

FFAS jap ciout shandshake serial byte out 
FFAS jap untlk ssend untalk out serial 

FFAE jap unlsn ssend unlisten out serial 

FFB1 jup listn ;send listen out serial 

FFA4 jap talk >send talk out serial 

FFS87 jao readss sreturn i/o status byte 

FFBA jap setlfs ;set la, fay sa 

FF30 jap setnaar sset length and fn adr 

FFCQ open jao Ciopen) sopen logical file 

FFC3 close jan Ciclosea) sclose logical file 

FFCS6 chkin jae Cichkin) sonen channal in 

FFCS ckout jao Cickout) sopen channal out 

FFCC clreh jap Cielrecn) sclosa i/o channel 

FFCF basin jmo Cibasin) sinput fro@ channel 

FFO2 bsout jao Cibsout) soutput to channel 

FFOS jmo loadsp sload from file 

FFO8 jae savesp s;save to file 

FFOS jao settin ;set internal clock 

FFOE jao rdtia sread internal clock 

FFE1 stop jmo Cistop) scan stop key 

FFE4 getin jao Cigetin) sget char from queue 

FFET clall jmp Cielall) sclose all files 

FFEA clock jap udtin sincrement clock 

FFED jap scror 3 sreturn scraen size Ceditor) 
FFF QO jap plot sraead/set xsy coord Ceditor) 
FFF 3 jmo iobase sreaturn i/o hase 

FFFS8 systen eword cl2a8node 

FRFFA eword nai sprocessor Nardware vectors 
FFEC eword reset 

FREE eword ira 


COMPOSITE SYSTEM SESORY “AP 


C54 Cartridges C $4 C128 ROS QAM Bancs (0-3) 
SFEPFR> 
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KERNAL 
CoOrror 


$E9990> 


179 and CHARS 


| 
{ 
| 
| 
] 
| 
{ 
| CHARS & CP/M 
{ 


$0000 .e mmr est coer ee er ese seer - 


paar Saree ae ae area ae ae cael = } EOTTOR 
tc¢9090>| | e277 | pooswre=| i cw eweemn le 
| | | | 
1 Aoolication§ | { | | “ONITOR 
$3050>] | Se ="F=2 easre peal ler cane acer [ee ee NR 
| Card 7 aT | | | | 
| { { | | é 
$a009>]_ doen nmnn ti Peer | | | SYSTEM 
| 1 { BASIC RAMC=| & 3ASTC 
} Aoplication | 1 1. TEXT 
| | | WI Z 
j Card - LO | | ! BAasIc 
| 1 | RAMI-| VARS 
$3009>| | tre were wee em eer ee ower ew ere nn n= I Cott adaten -- 1. 


RAM2=| FUTUPE 


BASIC RAW3=1 ZXOAND 


LO 


ents OE SD ance Gem S28 ome ame ee oo” Gee O88 aD oe oem ED cee Ow coe 8 com oe cme ow oe ees OF Oe es = ew OP = ow enw 


{ 
| 
| 
| 
| 
| 
| 
! 
| 
| 
| 


$600>------- s tacneteeeaiaetetanetenanameetetateatae 2 nen nnn e +--+ ----- === o----- 22--------- -- 


Come 


en ee meee ees ee ee ee ee tee ees a eee ce fee eee oe ae ee eee eee Se ae cee oo ee ee OO ow eee nw ew oe ewe —e op eee ee ow aoe ee ee a oe SO oe aw Oe 


$900 02" ?**s<s+-<= Clee nt ote OO 8 SOS OOOO TBD OTT ODT OBC OO e228 eo 8 8ee ©2822 e 2 eo ceecoe 


$9400>| ------------ acs 


9asic 
$0903> Pun-Tine 
Stack 


$08900> 


vic 


Text 
Screen 


CVNet) 


$9400> | --------------- 


i 
{ 
| 
i 
| 
| 
| 
| 
1 
| 
1 Sasic RA® Code| 
| 
| 
! 
i 


$9380>, ----+-+- = 
| Xernal Taoles 

$O33C>| -72e ef fF 2 © 
| Indirects 


S22 Cs ear ss=ses=sSe<= 
[Kernal 8AM Code| 


$J2A2>} - - = eee = | 
}Sasfe 3&3 Monitor] 
Inout 
| Buffer | 
$0200> | cee eweecocecre= | 
| System Stacx | 
$2149>| - ----- = 
Jdasic JOS/USING] 
$0110>] ---+--e-- 
| FRUFFER | 


$0100> | ewer wn nnn nee | 
| 
| Kermal 2.9. | 
$Q0090>]{ 02° el elmUcewmUCUCOWUCUCOUCUCU | 
| asic 2.8, | 
$O0902>} _ . . , Lk ' 
$2000 F li ce | 


$13C00>|<<-- a Same] 
| 
| Basic | 
| Absolute 1 
| Variaoles | 
| | 
$1290 | ---2----------- 
| Qasic | 
DOS / WSP | 
| Varianles { 


$1108 | ~c- ence wsecenn- | 


[CPs Yeset Code| 
$1100> | ---------------! 


Function 
Key 
Suffer 


$1000> 


Sprite 
s0FOD> Definition 


Area 


| 
| 
i 
| 
| 
| 
| 
| 
| 
| 
| 
[ 
[ 
| 
| 
| 
! 
| 
| 
83-232 { 
Jutput } 
3utfer | 
| 

| 

i 

| 

j 

| 

| 

| 

| 

| 

| 

| 

j 

! 

I 

| 

i 

| 

| 

j 


$0C00>| --------------- 
1 (Disk S3o0o0r 


| Page) 
so3cv>}] ---- - - 

| Cassette 

{ Suffer 
$0909> | -orenneencewece 

| Monitor & 


| Kernal 

| Absolute 
! Variaoles 
| 


$5 400> | enw eewreweoee=e= 


999999999 


$1000>] ------- secon en-| 
| | 

| 

! 

| | 
$1300>| | 
| 

1 2eserved | 

| | 

| For i 

| | 
$1400>| Funetion | 
| 

| Key { 

! 

| Software i 

| 
$1900>} { 
| 

| | 

| 

| | 

| 
$1800> | enon mn nnn nnn | 
| | 

| | 

| 

| 

| 

| | 

| 

| Reserved { 

| 

| for | 

| 

i Foreign i 

| | 

| Language | 

| 

} Systenas | 

| | 

| 

| | 

| 

| 

| 

$1400> | ----2-ee enna nn| 
| 

| | 

| 

| 

| | 

{ 


$1390>{ Sea aesen 2 eon ooaw @ 


SFEE E> | -<<-- eo----- --- 
SFFFA>| WMI RST IRQ 


| 
| 
SFFDO>! CP/4 RAM Code ! 
| Sent RAM Code | 
SFFQS> [o--------- o-----] 
1e"U Config eqs | 
SFFIO> | ome enterennne o--| 
Sasic 
Text 
Area 


(Basic Text 
begins at 
$1¢00 
if a{t-Mao 
umallocated) 


$4000> 


yIc 
3it-ao 


Sereen 


| Cyae2) 
$1C00> | woo res ett ecces~ 


[4/9 3L0CK AP 6526 CIA RESISTE2 SAP Ctypical) 


$0000 


SOPFFF — Per) ORE Re eee Re Oe REG8 FUNCTION 
| | sete te as etches 
| [I/O = 2 ] Fo eeae CAI Ccontral register 9) 
SOF in i set tt / E scee CRA Ccontrol register A) 
| | / D scceee [CR Cinterruot control register) 
| 1/90 = 1 } J C wcoe SOR (serial data register) 
$0600: ~ J ene eee eee Jf 9B ecce TOD (hours) 
| | A ccoe TOD (ainutes) 
| CIA = 2 } 9 weae. TO0 (seconds) 
$0000 a Doce e ee ee Sia 3 ecocs TOD (tenths) 
| | 7 cooe TETHI (timer 8) 
| CIA = 1 | § ence TS3-L9O 
$o0¢c99 = {.- a Fe tes ce, (ee S eoee TATHI (timer A) 
{ | \ & eseane TAwt0 
| vrc tN 3 eeee OORS Cdata directian sort 3) 
/ COLOR / \ 2 coee DORK (data direction port A) 
| RA™ | \ 1 e5cae PRI (port 3) 
$0300 .. loteessecesccscul View ewe) 8 coee PRA (port A) 
| ! 
| CRESERVED) | 
SOOO ie eee eat ee 
I | 
| 8563 V¥OC |] eceee Cregister sap on following pages) 
ek. 10) Ch: ee ne cen eee 
| ] 
] amy | eccce Cregister aap on following pages) 
$0500) = Fete ubed eee | 
| | ; 
| cB a) J eacce Cregister pao on following cages) 
$0600) 3 “We ae a 
| | 
| I 
/ vic f cecee Cregister map on following pages) 
1 | 
] j 


8722 =my REGISTER MAP 
REGISTER OESCRIPTION 
11 CVR) cecccccecccer | Te { eccee 3ANK Version 
Version Yegister 13 2° 0 | eeosee AAU Version 
aera! 
10 (PAGE“1 HI) wesece J? - 6 | eocee 279 i 
8 (PAGESO0 HI) $35 f wecccncee AIP Swaos PAGE 0 andlor PAGE 1 
$2 | eccccccee Al8 with any other page in the 
{ 1 ! Seeeeawsenw AUT 256K address space. 
{ 0 t eeaeeaeveaee A116 { 
[=== ! 
? CPAGE~1 LO) ceecee 7 | ecoesesece AIS | 
7 (PAGE) LO) ] 6 J @eeeenveovee A14 { 
| 5 | eeneavvene A13 | 
| 6 | eewoeeene A12 / 
| 3 | eaoeveeceaen At4 | 
} 2 { eeeeeneee A1Q | 
§ 4b ecccceccae AP | 
} 0 | ecocccccee A8 _- 
In--| 
6 (RCP) 1 7 f cecccccce VAI7Z \V VIC RAM Bank 
| 6 ] eaeneeeeee VA16 / 
RAM Configuration 3 =| -esemeweas.\ RAM Block (for future expansion) 
Register b & | ecccvcccs / 
} 3 2 eccccvcece \ SHARE Status (nonesdsotstopsdath) 
! 2 J eeeanaonnveare / 
1 | ee a a ee SMARE Asount CTeo dk, 8kr716k) 
} 0 | ecaccccce / 
I---| 
5 CMCR) { 7 | escscccee 60/80 Key Sense 
1} § | eeeaeoneveee 0s “ode 0 = 128. 1 = 64 
Yode Configuration b 5 J wecccccce SEXROM Line sense 
Register 1 § 2 eecccccce SGAME Line sense 
| 3 | eeccacecsose FSOIR 923 IN, 1 = OUT 
{ 2 | eeaoaeeaeae 72? 
| 1 | eeoeaaeaaeee 977 
1 0 | ceccccece PROCeSSOF: 0 = 7280 1 2 85xux 
I---| 
4 CPCR=-0) ] ? j eoeacecce A117 \ Ras BANK (0-3) 
3 CPCR-C) ! fe) | eccscvcce AIS / 
2 (PCR=-8) §$ S$ | weeccccecee \ ROMMHI Csystemsintsexts RAM) 
1 CPC P-A) ! 4 t ecoccccces / 
9 (Ca) J 3 { ecccceceee \ RQ04%-HT0 CsysteasintsextsRAM) 
t 2 | @eeeeeeoesse 4 
Pee-configuratian 1 1 f ecccccccccccencce ROMMLO Csystear RAM) 
g Configuration | ) { encccccccccacecres L/D (I/Os else see ROM-HT) 
[aon 


Registers 


© 
4 4 


Owwray DunF wm — 
6 


and 


Coreliminary) DMA CONTROLLER REGISTER map 


FAULT. es) of) ee ee Oh ae a cee of tee Status Register 


| 
Sum J} cm {| 27 JF Pe | NE ] MOOE lewen2w COMMaNd Register 
A6 | AS | AS JY 3 JY B2 JF Af JF AD JTLoLL_Luw Most Address lo 
AIS | ATS | A12 J ATT | AIO | ao | £8 FLL Host Address hi 
EXO | EXS | EXS J EX J EX2 Jf EXT | EXD FrovLricu Exoansion Address lo 
EX46 J EXT3 | EX12 J EXIT J EX10 | EXP |F EXZ [LLL_LL Expansion Aacdceress hi 
“=~ | om | wm fF er fF BA2 JF BAT J BAD JoLLLiuw Expansion Bank pointer 
Lo {| LS f Le F LE fF Le JF LI fF LO JoLLLLw Transfer Length Lo 
L1G Ff Ltd — LIA | LIT Y LIO F LF JF LI JroLLLLL Transfer Length hi 
$6 | $$ | ye | $3] $2. Ss | sQ. | Checksum 
| | ] | | | l 


Version & Max~Menory 


90: Yransfer FROM internal TO external 
O93: Tereansfer TO Internal FRO™ external 
10: Swao 

11: Verify 


PS) 


OCM@nNO NFwWN= OM 
8 


¢@ 8 Gt 


8564 VIC REGISTER MAP 


| sOx2 | SOx! | SOx0. 
ssi tae asl en ln ls eee ete es SOR Tee 
! | 


eocces SOrite 


Location 
Location 
Location 
Locatian 
locatian 
Location 
Location 
Location 
location 
Location 
Location 
Location 
Location 
Location 
Sprite Location 
Sorite Location 
"S8 of Sorite xX loctn 
aodes Brows, youscrall 
Raster Latch 
Lightpen X Latch 
Lightpen Y latch 
Sorite Disable 
aode, col, x«-scroltl 
Sprite Y expand 
V™ Bases CHR Base 
IR@ source (wrt to clr) 
TRQ enable (Ozdisable) 
Sorite/8gqnd Priority 
Multicolor Sprite Sel 
Sorite X exoand 
S/S Colliston Latch 
$/8 Collision Latch 
Sordee Color 
Background Color #0 
Background Color #1 
Background Color 82 
Backgraund Color 83 
Serite Multicolor #0 
Sprite Multicolor #1 
Sprite 0 Calor 
Sorite 1 Color 
Sprite 2 Coloe 
Sprite 3 Color 
Sorite & Color 
5 
6 


~mmewnwe lOPrTtE 


Sprite 
waaouee S0FIte 
Sorite 
Sorite 
Sprite 
Sorite 
Sprite 
Sorite 
Sprite 
Sorite 
Sorite 


1 
| 
| 
| 
| 
es eee 
| 
| 
| 
1 
| 


WYN AUNUYUE FW ~*~? OO 
Sa a, ee ee, a a a, oe a. a, 


$723 
RC3 
RC7 
LPx 8 
LPy? 
$07 


$623 
ecm 
RCS 
LPx7 
LPys 
$06 


$Sad 
34m 
RCS 
LPx6 
LPy5 
$D5 
Reset 
SSEy | S4SEy 
ve44 


$39 
ROWS 

RC3 
LP x4 
LPy3 


$4x8 


| 
J 
| 
! 
| 
| 
1 
| 
| 
| 
| 
| 
| 
| 
| 
i 
i 
{ 
j oe 
S7Ey } 
vais | 
rrRQ | 
sr ) J —- ee 
! 
| 
| 
} 
| 
| 
| 
{ 
| 
| 
i 
| 
| 
j 
| 
! 
j 
i 
| 
| 
| 
| 


S6Ey 
ymq2 


| 
! 
| 
| 
| 
} 
| 
| 
| 
| 
l 
( 
! 
i 
1 
| 
| 
l 
3$°7 S9SP6 } 3SP5 
“CS7 mcS6 | “"CS5 
S7Ex S6Ex |] SSEx 
$36 | 
$B6 | 
i 
| 
| 
{ 
i 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
{ 


$$7 
$87 


$$5 
$35 


0) 
“ 
v 
oO 


Sorite Color 

Sorite Color 

Sorite 7 Color 
Keyboard lines (new) © 
Clock speed 


| | 

| | 

{ | 

} 

| | 

| | 

| 1 

{ | 

{ { 

| ! 

| | 

| | 

{ l 

i | 

| | 

| | 

| { 

1 | 

| 1 

| | 

! | | 

| { | 
| LP | 28/5 | .S/8 

{ | ! 

! | 

| | l 

| | 1 

1 | | 

| { { 

l | | 

{ l | 

2S “ae ‘ 1 

! | | 

l i | 

| | { 

i | | 

} | | 

l | 1 

| \ | 
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4581 SID 2ESISTE? wap 

) F7 | Fo | FS Fh | F3 [| F2 ¢ F1 Y FO Joorrie 
} FIS J FIG | FITS JY FIZ J FIT J FID | FO Yo FB flo L oe 2 
} PWw7 Jf db | PWS | Poe JF PWS J Pwe | Pwl | PWO ToL 
Eo 27h fo ee fo ee J ee J Pwtt | aWwtd fo Pwo fo PeS FLL 
| NOISE} PULSES] Saw | TRI | TEST | RING J SYNC | GATE JL 
} ATKS | ATK2 J ATXt | ATKS J OCY3 | DBCv2 | OCYT |} OCYO FLL 
| STN3 J STN2 | STNT | STNO | PLSS J ALS2? | ALST | RESO JTL 
ORS eee ar reer e | Heres steers See eee ee ey 

1 7 | FS J FS [| Fe FY £3 JF Fe JF FY |F FO fForrree 
{, FIS | F146 { FIS | FI2 | £19 4 F100 | FO Y FB Food 
f P77 | PWO J PWS J Pw fF PWS Fo PwW2 | PWT J PWO JllLlL ss 
$m | mm JF er $F crm JF Pott | PWI1O | Awd J PWwW3 JoOL-LLLL 
J} NOISE} PULSE} SAw f TRI | TEST | @ING ] SYNC |] GATE J LLL 
} ATKS J aTK2 | ATK | ATKO f OCY3 | OCY2 { OCYT | OCYO JLT 
} STN3 J STN2 1 STNT J STND ] ALSS | ALS2 J REST | WSO JL Lie 
[ tee2ee [esse [Seeses (S22 4s" bres es= pee==2 =| pereo= | -=-e2= | 

1 F7 | Fe | FS | FS JY FS J Fe fF FT fF FO JoLorrie 
$ FIS | FIG | FIS 4 F122 YO FYE Yo FIC Y FO Fo FR Folll le 
1 PW7 [| Pwo | PWS {| Pwo [| Pw3 | Pwo J PWT J PWO fLo-LLU 
{ om FY or | cee F ce JF Pwtt { PW10 | PWH | PwB JOT Le 
J NOISE} PULSE} Saw | TRI | TEST | RING | SYNC | GATE JL 
} ATK3 | ATK2 { ATK1 | ATKO | OCY3 J OCY2 | OCY1 | OCYO JL 
| STN3 | STN2 | STNT J STNO J RLSS | RLES2 | ALST | ALSO Joo ie a 
(ee 22s eee ne ye sere | Seer Porras [oea== AL Rees l= | 2 siee ==, | 

} - { -- “- J} > f Fe2 | FCI J FCO Io 
1; Fc19 } FCO Y FCS J FCO? $ FCO Y FOS | FOS | FCS fone 
| 2€S3 | RES2 | REST | REST FRILTEX| FILTS] FILTIY FILTO] 
1 3 OFFS wR | 3P f LP | WOL3 J VOL2 | VOLT | VOLO J LULL 
[erre es | San se = |e aesr a [ees | ees | eee eee Seer se (ee ser 

) PH7 | PXH J PKS J| PKS J PRE | PH2 1 PXT | PXO TOLL 
1} PY7 | PY6 | PYS | PYS | PY3 [| PY2 J PYF 4 PYO JILL LLL 
} 07 | 08 | OS jf O&8 fF OF J 92 FY Of F 90 Joorie 
| 
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Frequency lo Volice=1 
Frequency hi 

Pulse width lo 

Pulse width hi 

Control Register 
Attack/Decay 
Sustain/Release 


Frequency loa 
Frequency hi 
Pulse wiith lo 
Pulse widtnr ri 
Control Register 
Attack/sDecay 
Sustain/Release 


Voice=2 


Frequency lo Votce-3 
Frequency hi 
Pylse width lo 
Pulse Width hi 
Control Register 
Attack/Oecay 
Sustain/Retlease 
Frequency to Filter 
Frequency hi 
Resonance/Filter 
Mode/Voluee 


Pot Xx 

Pot ¥ 
Iscillacor 3 
Envelope 3 


Misc. 


8563 voOC RESISTER MAP 
@EG Fe LL i ee tar oe ea gate er Saat NS SE ee epic es 
J. 1 wT7 {| %WT6 | HTS f| ATS | HWT3 J AT2 | HTT I 
1 | wo? | HDS | 405 | HOS | HO3d | HD2 | HOT | 
2. } WP? | 4P5H | MP5 | MPS fF MP3 | HP2 | HPT I 
x. 1 vw3 | Vw2 § Vel | VwO J ww § Hee | wwt | 
o. 1! vT7 | vwts | wrS | vVYS | vt3 | vwr2 | vrt 4 
5 f 2 Jf 2- | 2m fF VAS | VAS Yo VA2 | Val | 
6. 1 Vo7 | Vos | VO5 | YVOS | VO3 | YO2 | Vot | 
7. , vP? | vVP6 | veS | VPS | vRP3 | vP2 | yRT | 
8. [i ee Al ee ee em. oh. ee a ee a 
on f * J cm fF wm | CTVS | Crys 4 cTv2 { crvi | 
19, | -- | cut | cmd | ¢S4 | Cs3 — ¢S2 ] cst | 
1. } 7 JF 2 fF #7 fY CBS | CE3 | CE2 |} 2 ee | 
12_ } 9515 | 9914 | OST3 | OSI2 | 9811 | DS1C | OS9 | 
13. { 537 | 954 | O85 | O84 |} 0s3 | Os2 | 0$1 | 
16. } cP95 | CP14 | CP13 J] CPT2 | CPI | CPIO | CPd | 
15. 1 cP7 | ¢cP6 § C95 {| CPA | CPS | CP2 4 CPT | 
1$_ } LovV7 | LPVS | LPVS |] LOWS | LPV3 | LPV2 | LPVI | 
17, J} LPAW7 | LPH6 | LPWHS | LPRG | LPHS | LPH? | LPHT ] 
i | VATS | VATS | VATS | UAT? ¢ YUATT | YAION | VAD | 
19 } vUa7v | UA6 | VAS J VAS | VAS $ Ya2 | vat |{ 
20. { AA15 | AAT& J AATS J AATZ | AAMT J AAI1O | AAD | 
21, } AA? [| AAG J BAS f AAS J AAS J AA? | AAT | 
228 | CTH3 | CTH? | CTH41 J CTHO J CoM3 |] COM2 {| COHT | 
23. { a | “- | 27 Jf COVES | COVE | COV2 | COVI | 
26 } COPY J} RVS JCBRATE] VSSS | VSS3 | VWSS2 | vSST | 
25. | Texy } aTr | SEMI | OBL | HSS3 J] HSSZ ] HSS | 
25. } FG3 |} FG2 | £67 {| =%§FGO | 963 $ 9862 | 361 | 
or. { AI? | AT46 |} AIT5 | ATS | At3 | AT2 | AI | 
23 } cats | C81& {| C3493 f RAM J 2-- | se] J oe | 
29, Pomr J 2h J ote FUSES YO URS Yo UL2 | ued | 
30. 1 we7 } wWCO6 | wES {| 8S J wed J we? | wO1 | 
31. } OA7 | O46 | DAS | DAS | DAS | DAZ? | OAT J 
32. {1 BATS | BAte | 3AT3 | 3A42 | BAIT | 3BA10 | BAD | 
pe } 3A7 | 3A6 | BAS | BAS | 3BAd J BAZ J BAI | 
34 1 0€37 | OEBS | OFS | 0E24 | OESS | OEFB2 | OEBT | 
35 } O€€7 | DEES | DEES § OEES | DEES | DEEL | OEE | 
36. i m= J -- JY ee JF > JF ORRZ JF ORR]? | ORR | 
[ees Ss Se6Ss—2eS04S\e6s= 2546555 < e@eeaeneoeon - 
Description of MAPPED registers: 
$360C => agdress (urite): fee ef ee Sp ER 
status (read) : }STATUS| LP |JVSLANK] 
| | | 
$9501 -> data (r/w) } o7 | 068 | 0. 
ATTRISUTE Byte layout | ALT [| RVS { U 
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D4 


Horizontal Total 
Horizontal Jisplayed 
Horizontal Syne Position 
Vert/Horz Syne width 
Vertical Toral 

Vertical Total Adjust 
Vertical Ojsolayed 
Vertical Syne Position 
Intertace Sade 

Character Total Veerical 
Cursor Modes Start sean 
Cursor End Scan Line 
Display Start Address 4 
Display Start Address lo 
Cursor Posirion hi 
Cursor Position lo 

Light Pen Vertical 

Light Pen Horizontal 
Uodarte Address hi 

Update Address loa 
Attrinute Start Aar hi 
Attridute Start adr toa 
Character Tortth)s, Oso0lv) 
Character Osolv) 
Vertical smooth scroll 
Horizontal smooth scroll 
Foregnds8gnd Color 
Address Ineresent / ow 
Character 3ase Address 
Underline scan Line 

word Count 

Data 

Block Start Address hi 
Block Start Address lo 
Display Enandle 3egin 
Oisolay Enadle End 

DRAG Refresh rate 


03 J 83 fF O2 fF O28 


L of FLASH 


a | G | a I 


} 
{ 
| 
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The following SY"BOLS are used Dy the ¢/423 EDITOR. 


EN9LTOR irq VIC sereen hRancler deoends upon theme 


Sy aool 


29519 
26519 
LOCKS 
SC®@OLL 
SHFLAG 
RPTFLG 
3LNON 
BEEPER 
GRAPYMH 
2I0¢ 


INIT_ 


STATUS 


| | 


EXPLANATION 9F VARIOUS KERNALSENITTIOR FLAG BYTESs ETC. 
Jesceription 
7 4 5 & 3 2 : G 

i i 1 | | | 
f =~ | Cind | Coued] Cind J Coutds Coued] Cautd] Coue) | 
| | | | | i | ; 
1 7 |[CAPKEVICASMSTRICASSENICASASRT[CHAREN] HIRAM] LORAM{ 
| | | | | 1 | | i 
ee a ee i ne ee a 
j | | | } { | | { 
} SFE JLINKE? | | { | { | | 
| | i | | i | | | 
! o- | 22 J -= | ALT J ALPHAY CTRL J C= | SHIFT] 
1 | | | | { | | | 
F ALL | NONE $f we $f se Fo ee fF ee $F wm Fo eh | 
| | i | | i i { | 
LON: (] SRNR oR i ee i eee fee. a ee a Ae 
{ | i } | | | | | 
OM, Wi re a ee | Cer Oh: Se: "| ee of me of Se of 
| | | { | | { { { 
| ACM | SPLIT] Sam | 7<- { -- j; “= |} -- | ~= } 
| i | | 1 i | { | 
@O7SC): seme 2! eee Sees ee fe ee ee ee al 
| | | | 1 | | | 
JCMRSET] CINT { ~~ | ee J 22 JF = fF 27 | BASICS 
| | | { 
| 


ODO 08 C8 @ O@ A OO 2 OO OOO 08 OO 8 OO OO OO 8S O@ OO 0 OOO OO BDO es OOO Oe we { 


Note that the 
In wsost cases the 


Contents of these locations will Se olaced girectiy into the aoprsoriate 
eegister ana should be used by the user instead af the actual register, 


GRAPHS 
CHAREN 
vat 
¥A2 
va} 
V46 
SPLIT 

CUR"OO 
PAUSE 


w~eede¢een 


@swaenee 


Soee insigne 


CINIT_STATUS . 


@eaonvaeaedegea 
@eeaeeoeoeoe 
@e@eeaneoeneaeded 
eee eeese 


@oeeeae ©0208 @ 


° 


@oe@Qeowee8 @ 


See adove. [f = SFF then editor Leaves VIC alone. 
Mask for 28510 JScharen oft. 

VIC text soge Yideo Matrix & Character dase oointer. 
VIC gZgraohic wode Video “Matrix 3 3it Sao vointer. 
3563 text display base address. 

8563 attrioute dsase address. 


Tf split screen aades, contains value for ‘aiddte® raster [29. 
2563 cursor eode. 
Caontcoirs in effect flag. [s = 813 if sae 


{nto XERNAL syroois: 


SYSTEM_VECTIR.« 


See also abdowe. Lets systee know what Nas Seen initialized 
and what nmasn*t. Set to $00 by a reset Sut untouched By NST. 
Where the xernal goes when it has to go samewhere. It's set 
to SASIC COLD at reset. S3ASIC ttself sets it tao BASIC WARM 
after it has inited. The MONITOR respects it toa. 


this was bro ught to you 
from the archives of 


http://retro-commodore.eu 


